Get Account Transactions

Get a selection of transactions that affected the specified account.

Warning: XRP-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

400 Bad Request

This error case indicates that 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 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.

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.