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