Get Account Transactions

Get a selection of transactions that affected the specified account.

Warning: XAG-API is early alpha software. API methods and data formats are likely to change frequently in ways that break backwards compatibility.

Request Format

GET /accounts/{address}/transactions

This API method uses the following path parameters:

Field	Value	Required?	Description
address	String (Address)	Required	The account to query.

This API method uses the following query parameters:

Field	Value	Required?	Description
ledger_index	(Varies) (LedgerIndex)	Optional	The sequence number of the ledger to use, or a shortcut string to choose a ledger automatically. (See Specifying Ledgers )

Response Formats

404 Not Found

Not found

Media type: application/json

Formatted as a RippleAPIError

The response uses the following fields:

Field	Type	Required?	Description
errors	Array of ErrorItem	May be omitted	A list of errors that occurred when processing this request.
message	String	May be omitted	A human-readable error message summarizing the problem(s) that occurred.

400 Bad Request

The request was not properly formatted.

Media type: application/json

Formatted as a RippleAPIError

The response uses the following fields:

Field	Type	Required?	Description
errors	Array of ErrorItem	May be omitted	A list of errors that occurred when processing this request.
message	String	May be omitted	A human-readable error message summarizing the problem(s) that occurred.

200 OK

A successful response provides a list of transactions that affected the specified account.

Media type: application/json

Formatted as a AccountTransactions

The response uses the following fields:

Field	Type	Required?	Description
transactions	Array of Transaction Common Fields	May be omitted	A list of transactions to affect the account.
validated	Boolean	May be omitted	If true, all the transaction outcomes in this response come from validated ledgers, so they are final and immutable.
minLedgerVersion	Integer	May be omitted	The minimum ledger index searched when looking for transactions affecting this account.