Get Transaction

Look up the status and details of a transaction. By default, this method only returns data from ledger versions that have been validated by consensus.

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

Request Format

GET /transactions/{transaction_id}

This API method uses the following path parameters:

Field Value Required? Description
transaction_id String (TransactionID) Required The ID of the transaction to retrieve.

This API method uses the following query parameters:

Field Value Required? Description
min_ledger Number Optional (Optional) Use this with max_ledger to specify a range of up to 1000 ledger indexes, starting with this ledger (inclusive). If the server cannot find the transaction, it confirms whether it was able to search all the ledgers in the requested range. (Requires rippled v1.5.0+)
max_ledger Number Optional (Optional) Use this with min_ledger to specify a range of up to 1000 ledger indexes, ending with this ledger (inclusive). If the server cannot find the transaction, it confirms whether it was able to search all the ledgers in the requested range. (Requires rippled v1.5.0+)

Response Formats

404 Not Found

The transaction was not included in a fully-validated ledger version that the server has available. If you provided both the min_ledger and max_ledger fields in the request, the 404 txnNotFound response includes the searched_all field (requires rippled v1.5.0+).

Media type: application/json

500 Internal Server Error

One of the Universal Errors 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
message String May be omitted A human-readable error message summarizing the problem(s) that occurred.
errors Array of ErrorItem May be omitted A list of errors that occurred when processing this request.

200 OK

Transaction object. (Note that this command may successfully find the transaction even if it is included in a ledger outside the range of min_ledger to max_ledger.)

Media type: application/json

Formatted as a AppliedTransaction