{"templateId":"markdown","versions":[{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/transactions/viewing-assets/view-and-audit-api","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/v1.39/transactions/viewing-assets/view-and-audit-api","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/transactions/viewing-assets/view-and-audit-api","default":false,"active":true,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/transactions/viewing-assets/view-and-audit-api","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/transactions/viewing-assets/view-and-audit-api","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/transactions/viewing-assets/view-and-audit-api","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/transactions/viewing-assets/view-and-audit-api","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"View transactions","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"view-transactions","__idx":0},"children":["View transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can view different objects to obtain information about a transaction."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information about the different object types created in ","Ripple Custody"," for transactions, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/transactions/initiation"},"children":["Transaction initiation"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"view-transactions-for-a-transaction-order","__idx":1},"children":["View transactions for a transaction order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To view the transactions for a transaction order, call the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/reference/api/openapi/transactions/gettransactions"},"children":["List transactions"]}," operation, filtered by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderReference.id"]}," query parameter."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response includes information on the transactions from a blockchain perspective, including information on the specific ledger, the transaction hash, and the serialized raw transaction in the specific ledger format."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The section ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledgerTransactionData"]}," contains information on what was executed on the blockchain ledger. You can use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledgerTransactionId"]}," in any external blockchain viewer to view details of the transaction on the blockchain."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"view-the-transfers-for-a-transaction","__idx":2},"children":["View the transfers for a transaction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To view the transfers for a transaction, call the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/reference/api/openapi/transactions/gettransfers"},"children":["List transfers"]}," operation, filtered by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionID"]}," query parameter."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"view-incoming-transactions","__idx":3},"children":["View incoming transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Incoming transactions are not associated with a transaction order."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To view incoming transactions, call the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/reference/api/openapi/transactions/gettransactions"},"children":["List transactions"]}," operation, filtered with the query parameter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accountId"]},", if required."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a transaction has a null ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionOrderId"]},", that means this transaction is for an incoming transaction."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"view-the-status-of-a-transaction-order","__idx":4},"children":["View the status of a transaction order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To view the status of a transaction, call the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/reference/api/openapi/transactions/getorders"},"children":["Get transaction order details"]}," operation with the relevant transaction order ID."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response includes two different statuses:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processing.status"]},": The internal processing status of the transaction in ","Ripple Custody",". It reaches ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Completed"]}," status once the transaction is successfully broadcast."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/transactions/processing#ripple-custody-statuses"},"children":["Learn more about Ripple Custody transaction statuses"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledgerTransactionData.ledgerStatus"]},": The ledger service tracks the transaction on the ledger and detects if it is confirmed in a block. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Confirmed"]}," status is achieved once the finality value for the ledger is reached."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/transactions/processing#ledger-statuses"},"children":["Learn more about ledger transaction statuses"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the transaction is not executed or partially executed on chain, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledgerTransactionData.failure"]}," field shows a non-null value, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PartiallyFailedOnChain"]},". In a scenario such as this, you need to conduct a thorough investigation to discover the root cause of the failure on chain."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We can conclude that a transaction was both successfully broadcast and executed on chain when:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledgerTransactionData.ledgerStatus"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Confirmed"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledgerTransactionData.failure"]}," null."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also view other data in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledgerData"]}," block of the transaction order, such as:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdContractAddresses"]},": Addresses of any smart contracts deployed, reported by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREATE"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREATE2"]}," functions of the smart contract. The value corresponds to an array, as it is possible to deploy multiple contracts using a single transaction."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the transaction involves the destruction of an existing contract, the transaction includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledgerData.deletedContractAddresses"]},", exposing all the contract addresses reported by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUICIDE"]}," functions of the smart contract."]}]},"headings":[{"value":"View transactions","id":"view-transactions","depth":1},{"value":"View transactions for a transaction order","id":"view-transactions-for-a-transaction-order","depth":2},{"value":"View the transfers for a transaction","id":"view-the-transfers-for-a-transaction","depth":2},{"value":"View incoming transactions","id":"view-incoming-transactions","depth":2},{"value":"View the status of a transaction order","id":"view-the-status-of-a-transaction-order","depth":2}],"frontmatter":{"seo":{"title":"View transactions"}},"lastModified":"2026-07-27T10:10:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.38/transactions/viewing-assets/view-and-audit-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}