# tx [[Source]](https://github.com/XRPLF/rippled/blob/master/src/xrpld/rpc/handlers/Tx.cpp) The `tx` method retrieves information on a single [transaction](/es-es/docs/references/protocol/transactions), by its [identifying hash](/docs/concepts/transactions#identifying-transactions) or its [CTID](/es-es/docs/references/http-websocket-apis/api-conventions/ctid). ## Request Format An example of the request format: WebSocket (Hash) ```json { "id": 1, "command": "tx", "transaction": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9", "binary": false, "api_version": 2 } ``` WebSocket (CTID) ```json { "id": "CTID example", "command": "tx", "ctid": "C005523E00000000", "binary": false, "api_version": 2 } ``` JSON-RPC (Hash) ```json { "method": "tx", "params": [ { "transaction": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9", "binary": false, "api_version": 2 } ] } ``` JSON-RPC (CTID) ```json { "method": "tx", "params": [ { "ctid": "C005523E00000000", "binary": false, "api_version": 2 } ] } ``` Commandline ```sh #Syntax: tx transaction [binary] rippled tx C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9 false ``` The request includes the following parameters: | Field | Type | Required? | Description | | --- | --- | --- | --- | | `ctid` | String | No | The [compact transaction identifier](/es-es/docs/references/http-websocket-apis/api-conventions/ctid) of the transaction to look up. Must use uppercase hexadecimal only. New in: rippled 1.12.0 *(Not supported in Clio v2.0 and earlier)* | | `transaction` | String | No | The 256-bit hash of the transaction to look up, as hexadecimal. | | `binary` | Boolean | No | If `true`, return transaction data and metadata as binary [serialized](/es-es/docs/references/protocol/binary-format) to hexadecimal strings. If `false`, return transaction data and metadata as JSON. The default is `false`. | | `min_ledger` | Number | No | Use this with `max_ledger` to specify a range of up to 1000 [ledger indexes](/docs/references/protocol/data-types/basic-data-types#ledger-index), starting with this ledger (inclusive). If the server [cannot find the transaction](#not-found-response), it confirms whether it was able to search all the ledgers in this range. | | `max_ledger` | Number | No | Use this with `min_ledger` to specify a range of up to 1000 [ledger indexes](/docs/references/protocol/data-types/basic-data-types#ledger-index), ending with this ledger (inclusive). If the server [cannot find the transaction](#not-found-response), it confirms whether it was able to search all the ledgers in the requested range. | You must provide *either* `ctid` or `transaction`, but not both. This command may successfully find the transaction even if it is included in a ledger *outside* the range of `min_ledger` to `max_ledger`. ## Response Format An example of a successful response: WebSocket (Hash) { "result": { "tx_json": { "Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", "DeliverMax": { "currency": "USD", "issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "value": "1" }, "Destination": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "Fee": "10", "Flags": 0, "Paths": [ [ { "account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", "currency": "USD", "issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", "type": 49 } ], [ { "account": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x", "currency": "USD", "issuer": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x", "type": 49 }, { "account": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY", "currency": "USD", "issuer": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY", "type": 49 }, { "account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", "currency": "USD", "issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", "type": 49 } ] ], "SendMax": { "currency": "USD", "issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", "value": "1.01" }, "Sequence": 88, "SigningPubKey": "02EAE5DAB54DD8E1C49641D848D5B97D1B29149106174322EDF98A1B2CCE5D7F8E", "TransactionType": "Payment", "TxnSignature": "30440220791B6A3E036ECEFFE99E8D4957564E8C84D1548C8C3E80A87ED1AA646ECCFB16022037C5CAC97E34E3021EBB426479F2ACF3ACA75DB91DCC48D1BCFB4CF547CFEAA0", "date": 416445410, "ledger_index": 348734 }, "ctid": "C005523E00000000", "hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7", "meta": { "AffectedNodes": [ { "ModifiedNode": { "FinalFields": { "Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", "Balance": "59328999119", "Flags": 0, "OwnerCount": 11, "Sequence": 89 }, "LedgerEntryType": "AccountRoot", "LedgerIndex": "E0D7BDE68B468FF0B8D948FD865576517DA987569833A05374ADB9A72E870A06", "PreviousFields": { "Balance": "59328999129", "Sequence": 88 }, "PreviousTxnID": "C26AA6B4F7C3B9F55E17CD0D11F12032A1C7AD2757229FFD277C9447A8815E6E", "PreviousTxnLgrSeq": 348700 } }, { "ModifiedNode": { "FinalFields": { "Balance": { "currency": "USD", "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji", "value": "-1" }, "Flags": 131072, "HighLimit": { "currency": "USD", "issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "value": "100" }, "HighNode": "0", "LowLimit": { "currency": "USD", "issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", "value": "0" }, "LowNode": "0" }, "LedgerEntryType": "RippleState", "LedgerIndex": "EA4BF03B4700123CDFFB6EB09DC1D6E28D5CEB7F680FB00FC24BC1C3BB2DB959", "PreviousFields": { "Balance": { "currency": "USD", "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji", "value": "0" } }, "PreviousTxnID": "53354D84BAE8FDFC3F4DA879D984D24B929E7FEB9100D2AD9EFCD2E126BCCDC8", "PreviousTxnLgrSeq": 343570 } } ], "TransactionIndex": 0, "TransactionResult": "tesSUCCESS", "delivered_amount": "unavailable" }, "validated": true, "ledger_index": 348734, "ledger_hash": "195F62F34EB2CCFA4C5888BA20387E82EB353DDB4508BAE6A835AF19FB8B0C09", "close_time_iso": "2013-03-12T23:16:50Z" }, "api_version": 2, "status": "success", "type": "response" } WebSocket (CTID) { "result": { "tx_json": { "Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", "DeliverMax": { "currency": "USD", "issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "value": "1" }, "Destination": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "Fee": "10", "Flags": 0, "Paths": [ [ { "account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", "currency": "USD", "issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", "type": 49 } ], [ { "account": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x", "currency": "USD", "issuer": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x", "type": 49 }, { "account": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY", "currency": "USD", "issuer": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY", "type": 49 }, { "account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", "currency": "USD", "issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", "type": 49 } ] ], "SendMax": { "currency": "USD", "issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", "value": "1.01" }, "Sequence": 88, "SigningPubKey": "02EAE5DAB54DD8E1C49641D848D5B97D1B29149106174322EDF98A1B2CCE5D7F8E", "TransactionType": "Payment", "TxnSignature": "30440220791B6A3E036ECEFFE99E8D4957564E8C84D1548C8C3E80A87ED1AA646ECCFB16022037C5CAC97E34E3021EBB426479F2ACF3ACA75DB91DCC48D1BCFB4CF547CFEAA0", "date": 416445410, "ledger_index": 348734 }, "ctid": "C005523E00000000", "hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7", "meta": { "AffectedNodes": [ { "ModifiedNode": { "FinalFields": { "Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", "Balance": "59328999119", "Flags": 0, "OwnerCount": 11, "Sequence": 89 }, "LedgerEntryType": "AccountRoot", "LedgerIndex": "E0D7BDE68B468FF0B8D948FD865576517DA987569833A05374ADB9A72E870A06", "PreviousFields": { "Balance": "59328999129", "Sequence": 88 }, "PreviousTxnID": "C26AA6B4F7C3B9F55E17CD0D11F12032A1C7AD2757229FFD277C9447A8815E6E", "PreviousTxnLgrSeq": 348700 } }, { "ModifiedNode": { "FinalFields": { "Balance": { "currency": "USD", "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji", "value": "-1" }, "Flags": 131072, "HighLimit": { "currency": "USD", "issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "value": "100" }, "HighNode": "0", "LowLimit": { "currency": "USD", "issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", "value": "0" }, "LowNode": "0" }, "LedgerEntryType": "RippleState", "LedgerIndex": "EA4BF03B4700123CDFFB6EB09DC1D6E28D5CEB7F680FB00FC24BC1C3BB2DB959", "PreviousFields": { "Balance": { "currency": "USD", "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji", "value": "0" } }, "PreviousTxnID": "53354D84BAE8FDFC3F4DA879D984D24B929E7FEB9100D2AD9EFCD2E126BCCDC8", "PreviousTxnLgrSeq": 343570 } } ], "TransactionIndex": 0, "TransactionResult": "tesSUCCESS", "delivered_amount": "unavailable" }, "validated": true, "ledger_index": 348734, "ledger_hash": "195F62F34EB2CCFA4C5888BA20387E82EB353DDB4508BAE6A835AF19FB8B0C09", "close_time_iso": "2013-03-12T23:16:50Z" }, "id": "CTID example", "api_version": 2, "status": "success", "type": "response" } JSON-RPC (Hash) { "result": { "tx_json": { "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", "Fee": "12", "Flags": 0, "LastLedgerSequence": 56865248, "OfferSequence": 5037708, "Sequence": 5037710, "SigningPubKey": "03B51A3EDF70E4098DA7FB053A01C5A6A0A163A30ED1445F14F87C7C3295FCB3BE", "TakerGets": "15000000000", "TakerPays": { "currency": "CNY", "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", "value": "20160.75" }, "TransactionType": "OfferCreate", "TxnSignature": "3045022100A5023A0E64923616FCDB6D664F569644C7C9D1895772F986CD6B981B515B02A00220530C973E9A8395BC6FE2484948D2751F6B030FC7FB8575D1BFB406368AD554D9", "date": 648248020, "ledger_index": 56865245 }, "ctid": "C363B1DD00000000", "hash": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9", "meta": { "AffectedNodes": [{ "ModifiedNode": { "FinalFields": { "ExchangeRate": "4f04c66806cf7400", "Flags": 0, "RootIndex": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", "TakerGetsCurrency": "0000000000000000000000000000000000000000", "TakerGetsIssuer": "0000000000000000000000000000000000000000", "TakerPaysCurrency": "000000000000000000000000434E590000000000", "TakerPaysIssuer": "CED6E99370D5C00EF4EBF72567DA99F5661BFB3A" }, "LedgerEntryType": "DirectoryNode", "LedgerIndex": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400" } }, { "ModifiedNode": { "FinalFields": { "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", "Balance": "10404767991", "Flags": 0, "OwnerCount": 3, "Sequence": 5037711 }, "LedgerEntryType": "AccountRoot", "LedgerIndex": "1DECD9844E95FFBA273F1B94BA0BF2564DDF69F2804497A6D7837B52050174A2", "PreviousFields": { "Balance": "10404768003", "Sequence": 5037710 }, "PreviousTxnID": "4DC47B246B5EB9CCE92ABA8C482479E3BF1F946CABBEF74CA4DE36521D5F9008", "PreviousTxnLgrSeq": 56865244 } }, { "DeletedNode": { "FinalFields": { "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", "BookDirectory": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", "BookNode": "0", "Flags": 0, "OwnerNode": "0", "PreviousTxnID": "8F5FF57B404827F12BDA7561876A13C3E3B3095CBF75334DBFB5F227391A660C", "PreviousTxnLgrSeq": 56865244, "Sequence": 5037708, "TakerGets": "15000000000", "TakerPays": { "currency": "CNY", "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", "value": "20160.75" } }, "LedgerEntryType": "Offer", "LedgerIndex": "26AAE6CA8D29E28A47C92ADF22D5D96A0216F0551E16936856DDC8CB1AAEE93B" } }, { "ModifiedNode": { "FinalFields": { "Flags": 0, "IndexNext": "0", "IndexPrevious": "0", "Owner": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", "RootIndex": "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548" }, "LedgerEntryType": "DirectoryNode", "LedgerIndex": "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548" } }, { "CreatedNode": { "LedgerEntryType": "Offer", "LedgerIndex": "8BAEE3C7DE04A568E96007420FA11ABD0BC9AE44D35932BB5640E9C3FB46BC9B", "NewFields": { "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", "BookDirectory": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", "Sequence": 5037710, "TakerGets": "15000000000", "TakerPays": { "currency": "CNY", "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", "value": "20160.75" } } } }], "TransactionIndex": 0, "TransactionResult": "tesSUCCESS" }, "validated": true, "ledger_index": 56865245, "ledger_hash": "793E56131D8D4ABFB27FA383BFC44F2978B046E023FF46C588D7E0C874C2472A", "close_time_iso": "2020-07-16T20:53:40Z", "status": "success" } } JSON-RPC (CTID) { "result": { "tx_json": { "Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", "DeliverMax": { "currency": "USD", "issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "value": "1" }, "Destination": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "Fee": "10", "Flags": 0, "Paths": [ [{ "account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", "currency": "USD", "issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", "type": 49 }], [{ "account": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x", "currency": "USD", "issuer": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x", "type": 49 }, { "account": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY", "currency": "USD", "issuer": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY", "type": 49 }, { "account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", "currency": "USD", "issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", "type": 49 }] ], "SendMax": { "currency": "USD", "issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", "value": "1.01" }, "Sequence": 88, "SigningPubKey": "02EAE5DAB54DD8E1C49641D848D5B97D1B29149106174322EDF98A1B2CCE5D7F8E", "TransactionType": "Payment", "TxnSignature": "30440220791B6A3E036ECEFFE99E8D4957564E8C84D1548C8C3E80A87ED1AA646ECCFB16022037C5CAC97E34E3021EBB426479F2ACF3ACA75DB91DCC48D1BCFB4CF547CFEAA0", "date": 416445410, "ledger_index": 348734 }, "ctid": "C005523E00000000", "hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7", "meta": { "AffectedNodes": [{ "ModifiedNode": { "FinalFields": { "Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", "Balance": "59328999119", "Flags": 0, "OwnerCount": 11, "Sequence": 89 }, "LedgerEntryType": "AccountRoot", "LedgerIndex": "E0D7BDE68B468FF0B8D948FD865576517DA987569833A05374ADB9A72E870A06", "PreviousFields": { "Balance": "59328999129", "Sequence": 88 }, "PreviousTxnID": "C26AA6B4F7C3B9F55E17CD0D11F12032A1C7AD2757229FFD277C9447A8815E6E", "PreviousTxnLgrSeq": 348700 } }, { "ModifiedNode": { "FinalFields": { "Balance": { "currency": "USD", "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji", "value": "-1" }, "Flags": 131072, "HighLimit": { "currency": "USD", "issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "value": "100" }, "HighNode": "0", "LowLimit": { "currency": "USD", "issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", "value": "0" }, "LowNode": "0" }, "LedgerEntryType": "RippleState", "LedgerIndex": "EA4BF03B4700123CDFFB6EB09DC1D6E28D5CEB7F680FB00FC24BC1C3BB2DB959", "PreviousFields": { "Balance": { "currency": "USD", "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji", "value": "0" } }, "PreviousTxnID": "53354D84BAE8FDFC3F4DA879D984D24B929E7FEB9100D2AD9EFCD2E126BCCDC8", "PreviousTxnLgrSeq": 343570 } }], "TransactionIndex": 0, "TransactionResult": "tesSUCCESS", "delivered_amount": "unavailable" }, "validated": true, "ledger_index": 348734, "ledger_hash": "195F62F34EB2CCFA4C5888BA20387E82EB353DDB4508BAE6A835AF19FB8B0C09", "close_time_iso": "2013-03-12T23:16:50Z", "status": "success" } } Commandline ```json { "result" : { "Account" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", "Fee" : "12", "Flags" : 0, "LastLedgerSequence" : 56865248, "OfferSequence" : 5037708, "Sequence" : 5037710, "SigningPubKey" : "03B51A3EDF70E4098DA7FB053A01C5A6A0A163A30ED1445F14F87C7C3295FCB3BE", "TakerGets" : "15000000000", "TakerPays" : { "currency" : "CNY", "issuer" : "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", "value" : "20160.75" }, "TransactionType" : "OfferCreate", "TxnSignature" : "3045022100A5023A0E64923616FCDB6D664F569644C7C9D1895772F986CD6B981B515B02A00220530C973E9A8395BC6FE2484948D2751F6B030FC7FB8575D1BFB406368AD554D9", "date" : 648248020, "hash" : "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9", "inLedger" : 56865245, "ledger_index" : 56865245, "meta" : { "AffectedNodes" : [ { "ModifiedNode" : { "FinalFields" : { "ExchangeRate" : "4F04C66806CF7400", "Flags" : 0, "RootIndex" : "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", "TakerGetsCurrency" : "0000000000000000000000000000000000000000", "TakerGetsIssuer" : "0000000000000000000000000000000000000000", "TakerPaysCurrency" : "000000000000000000000000434E590000000000", "TakerPaysIssuer" : "CED6E99370D5C00EF4EBF72567DA99F5661BFB3A" }, "LedgerEntryType" : "DirectoryNode", "LedgerIndex" : "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400" } }, { "ModifiedNode" : { "FinalFields" : { "Account" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", "Balance" : "10404767991", "Flags" : 0, "OwnerCount" : 3, "Sequence" : 5037711 }, "LedgerEntryType" : "AccountRoot", "LedgerIndex" : "1DECD9844E95FFBA273F1B94BA0BF2564DDF69F2804497A6D7837B52050174A2", "PreviousFields" : { "Balance" : "10404768003", "Sequence" : 5037710 }, "PreviousTxnID" : "4DC47B246B5EB9CCE92ABA8C482479E3BF1F946CABBEF74CA4DE36521D5F9008", "PreviousTxnLgrSeq" : 56865244 } }, { "DeletedNode" : { "FinalFields" : { "Account" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", "BookDirectory" : "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", "BookNode" : "0000000000000000", "Flags" : 0, "OwnerNode" : "0000000000000000", "PreviousTxnID" : "8F5FF57B404827F12BDA7561876A13C3E3B3095CBF75334DBFB5F227391A660C", "PreviousTxnLgrSeq" : 56865244, "Sequence" : 5037708, "TakerGets" : "15000000000", "TakerPays" : { "currency" : "CNY", "issuer" : "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", "value" : "20160.75" } }, "LedgerEntryType" : "Offer", "LedgerIndex" : "26AAE6CA8D29E28A47C92ADF22D5D96A0216F0551E16936856DDC8CB1AAEE93B" } }, { "ModifiedNode" : { "FinalFields" : { "Flags" : 0, "IndexNext" : "0000000000000000", "IndexPrevious" : "0000000000000000", "Owner" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", "RootIndex" : "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548" }, "LedgerEntryType" : "DirectoryNode", "LedgerIndex" : "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548" } }, { "CreatedNode" : { "LedgerEntryType" : "Offer", "LedgerIndex" : "8BAEE3C7DE04A568E96007420FA11ABD0BC9AE44D35932BB5640E9C3FB46BC9B", "NewFields" : { "Account" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", "BookDirectory" : "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", "Sequence" : 5037710, "TakerGets" : "15000000000", "TakerPays" : { "currency" : "CNY", "issuer" : "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", "value" : "20160.75" } } } } ], "TransactionIndex" : 0, "TransactionResult" : "tesSUCCESS" }, "status" : "success", "validated" : true } } ``` API v2 The response follows the [standard format](/docs/references/http-websocket-apis/api-conventions/response-formatting), with a successful result containing the fields of the [Transaction object](/es-es/docs/references/protocol/transactions) as well as the following additional fields: | `Field` | Type | Description | | --- | --- | --- | | `ctid` | String | The transaction's [compact transaction identifier](/es-es/docs/references/http-websocket-apis/api-conventions/ctid). New in: rippled 1.12.0 *(Not supported in Clio v2.0 and earlier.)* | | `date` | Number | The [close time](/es-es/docs/concepts/ledgers/ledger-close-times) of the ledger in which the transaction was applied, in [seconds since the Ripple Epoch](/docs/references/protocol/data-types/basic-data-types#specifying-time). | | `hash` | String | The unique [identifying hash](/docs/concepts/transactions#identifying-transactions) of the transaction | | `inLedger` | Number | *(Deprecated)* Alias for `ledger_index`. | | `ledger_index` | Number | The [ledger index](/docs/references/protocol/data-types/basic-data-types#ledger-index) of the ledger that includes this transaction. | | `meta` | Object (JSON) | (JSON mode) [Transaction metadata](/es-es/docs/references/protocol/transactions/metadata), which describes the results of the transaction. | | `meta_blob` | String (binary) | (Binary mode) [Transaction metadata](/es-es/docs/references/protocol/transactions/metadata), which describes the results of the transaction, represented as a hex string. | | `tx_blob` | String (binary) | (Binary mode) The transaction data represented as a hex string. | | `tx_json` | Object (JSON) | The transaction data represented in JSON. | | `validated` | Boolean | If `true`, this data comes from a validated ledger version; if omitted or set to `false`, this data is not final. | API v1 The response follows the [standard format](/docs/references/http-websocket-apis/api-conventions/response-formatting), with a successful result containing the fields of the [Transaction object](/es-es/docs/references/protocol/transactions) as well as the following additional fields: | `Field` | Type | Description | | --- | --- | --- | | `ctid` | String | The transaction's [compact transaction identifier](/es-es/docs/references/http-websocket-apis/api-conventions/ctid). New in: rippled 1.12.0 *(Not supported in Clio v2.0 and earlier.)* | | `date` | Number | The [close time](/es-es/docs/concepts/ledgers/ledger-close-times) of the ledger in which the transaction was applied, in [seconds since the Ripple Epoch](/docs/references/protocol/data-types/basic-data-types#specifying-time). | | `hash` | String | The unique [identifying hash](/docs/concepts/transactions#identifying-transactions) of the transaction | | `inLedger` | Number | *(Deprecated)* Alias for `ledger_index`. | | `ledger_index` | Number | The [ledger index](/docs/references/protocol/data-types/basic-data-types#ledger-index) of the ledger that includes this transaction. | | `meta` | Object (JSON) or String (binary) | [Transaction metadata](/es-es/docs/references/protocol/transactions/metadata), which describes the results of the transaction. | | `tx` | String (binary) | (Binary mode) The transaction data represented as a hex string. | | `validated` | Boolean | If `true`, this data comes from a validated ledger version; if omitted or set to `false`, this data is not final. | | (Various) | (Various) | Other fields from the [Transaction object](/es-es/docs/references/protocol/transactions) | ### Not Found Response If the server does not find the transaction, it returns a `txnNotFound` error, which could mean two things: - The transaction has not been included in any ledger version, and has not been executed. - The transaction was included in a ledger version that the server does not have available. This means that a `txnNotFound` on its own is not enough to know the [final outcome of a transaction](/es-es/docs/concepts/transactions/finality-of-results). To further narrow down the possibilities, you can provide a range of ledgers to search using the `min_ledger` and `max_ledger` fields in the request. If you provide **both** of those fields, the `txnNotFound` response includes the following field: | Field | Type | Description | | --- | --- | --- | | `searched_all` | Boolean | *(Omitted unless the request provided `min_ledger` and `max_ledger`)* If `true`, the server was able to search all of the specified ledger versions, and the transaction was in none of them. If `false`, the server did not have all of the specified ledger versions available, so it is not sure if one of them might contain the transaction. | An example of a `txnNotFound` response that fully searched a requested range of ledgers: WebSocket ```json { "error": "txnNotFound", "error_code": 29, "error_message": "Transaction not found.", "id": 1, "request": { "binary": false, "command": "tx", "id": 1, "max_ledger": 54368673, "min_ledger": 54368573, "transaction": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7" }, "searched_all": true, "status": "error", "type": "response" } ``` JSON-RPC ```json 200 OK { "result": { "error": "txnNotFound", "error_code": 29, "error_message": "Transaction not found.", "request": { "binary": false, "command": "tx", "max_ledger": 54368673, "min_ledger": 54368573, "transaction": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7" }, "searched_all": true, "status": "error" } } ``` ## Possible Errors * Any of the [universal error types](/docs/references/http-websocket-apis/api-conventions/error-formatting#universal-errors). * `invalidParams` - One or more fields are specified incorrectly, or one or more required fields are missing. * `txnNotFound` - Either the transaction does not exist, or it was part of an ledger version that `rippled` does not have available. * `excessiveLgrRange` - The `min_ledger` and `max_ledger` fields of the request are more than 1000 apart. * `invalidLgrRange` - The specified `min_ledger` is larger than the `max_ledger`, or one of those parameters is not a valid ledger index.