For AI agents: a documentation index is available at /llms.txt. A markdown version of this page is available at the same URL with .md appended (or via Accept: text/markdown).
Skip to main content

getTransactions

Returns transactions starting at a ledger sequence or paging cursor. This method uses 160 credits from your daily balance.

The requested transactions must fall within the history the node retains.

Parameters​

  • startLedger: (integer) [optional] - Ledger sequence to start from, inclusive. The node returns an error if this is outside the ledgers it has stored. Omit this field when pagination.cursor is set.
  • pagination: (object) [optional] - Paging options:
    • cursor: (string) [optional] - Paging token. Set this to the cursor from the previous response to fetch the next page.
    • limit: (integer) [optional] - Maximum number of transactions to return. The range is 1 to 200. The default is 50.
  • xdrFormat: (string) [optional] - Format for XDR fields in the response. base64 is the default. json returns unpacked JSON. Do not rely on a stable schema for the JSON form, because it changes when the underlying XDR changes.

Returns​

result: (object) - A page of transactions.

  • transactions: (array) - Transactions in the page. Each transaction contains:
    • status: (string) - SUCCESS or FAILED.
    • txHash: (string) - Hex-encoded transaction hash.
    • applicationOrder: (integer) - 1-based index of the transaction among transactions in the ledger.
    • feeBump: (boolean) - true when the transaction was fee-bumped.
    • ledger: (integer) - Sequence number of the ledger that included the transaction.
    • createdAt: (integer) - Unix timestamp of when the transaction was included.
    • envelopeXdr: (string) - Base64-encoded TransactionEnvelope.
    • resultXdr: (string) - Base64-encoded TransactionResult.
    • resultMetaXdr: (string) - Base64-encoded transaction metadata.
    • diagnosticEventsXdr: (array) [optional] - Base64-encoded diagnostic events. Present when diagnostic events are enabled on the RPC server.
    • events: (object) - Events emitted while the transaction was applied.
      • transactionEventsXdr: (array) - Base64-encoded transaction events, such as fees charged or refunded.
      • contractEventsXdr: (array) - Nested arrays of base64-encoded contract events, one array per operation.
  • latestLedger: (integer) - Sequence number of the latest ledger known to the node when it handled the request.
  • latestLedgerCloseTimestamp: (integer) - Unix timestamp of when that ledger closed.
  • oldestLedger: (integer) - Sequence number of the oldest ledger kept in history.
  • oldestLedgerCloseTimestamp: (integer) - Unix timestamp of when that ledger closed.
  • cursor: (string) - Paging token for the next page.

Request​

curl https://stellar-mainnet.infura.io/v3/<YOUR-API-KEY> \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "getTransactions", "params": {"startLedger": 64923183, "pagination": {"limit": 1}}}'

Response​

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"transactions": [
{
"status": "SUCCESS",
"txHash": "a90606c6676698aae7a1b5b4cb31bb5878f6ce16a953ed42c609f2e9aa566052",
"applicationOrder": 1,
"feeBump": false,
"envelopeXdr": "AAAAAgAAAAB1dNk+2z+no5a3Cqu3uBe87zLl6MLXKGUyC63PV1CELwAAA+gD0klhAAOOewAAAAEAAAAAAAAAAAAAAABqzkAaAAAAAAAAAAEAAAAAAAAAAwAAAAFYUlAAAAAAAG8Xr51rziqwpQYzWlSlqqSM79rNyv+jRJthuCssKt8RAAAAAAAAAAATScL2AAi52wABOIAAAAAAbvHsRgAAAAAAAAABV1CELwAAAEDeit3pRge5ykrEWESfkSGvTIEWBqZpyun48GSnIUh5T/aMgFbJRfaxpPvpblVHUTmjzVmLbsqV4QJztaSDnogD",
"resultXdr": "AAAAAAAAAGQAAAAAAAAAAQAAAAAAAAADAAAAAAAAAAAAAAABAAAAAHV02T7bP6ejlrcKq7e4F7zvMuXowtcoZTILrc9XUIQvAAAAAG7x7EYAAAABWFJQAAAAAABvF6+da84qsKUGM1pUpaqkjO/azcr/o0SbYbgrLCrfEQAAAAAAAAAAE0nC9gAIudsAATiAAAAAAAAAAAAAAAAA",
"resultMetaXdr": "AAAABAAAAAAAAAACAAAAAwPepi8AAAAAAAAAAHV02T7bP6ejlrcKq7e4F7zvMuXowtcoZTILrc9XUIQvAAAACNWIg+wD0klhAAOOegAAAAYAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAEAAAACskO0KAAAAAAAAAAAAAAAAgAAAAAAAAAAAAAAAAAAAAMAAAAAA96mLQAAAABqzj/3AAAAAAAAAAED3qYvAAAAAAAAAAB1dNk+2z+no5a3Cqu3uBe87zLl6MLXKGUyC63PV1CELwAAAAjViIPsA9JJYQADjnsAAAAGAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAABAAAAArJDtCgAAAAAAAAAAAAAAAIAAAAAAAAAAAAAAAAAAAADAAAAAAPepi8AAAAAas5AAQAAAAAAAAABAAAAAAAAAAYAAAADA96mJAAAAAIAAAAAdXTZPts/p6OWtwqrt7gXvO8y5ejC1yhlMgutz1dQhC8AAAAAbvHsRgAAAAFYUlAAAAAAAG8Xr51rziqwpQYzWlSlqqSM79rNyv+jRJthuCssKt8RAAAAAAAAAAATSg5vAIhahwATEtAAAAAAAAAAAAAAAAAAAAABA96mLwAAAAIAAAAAdXTZPts/p6OWtwqrt7gXvO8y5ejC1yhlMgutz1dQhC8AAAAAbvHsRgAAAAFYUlAAAAAAAG8Xr51rziqwpQYzWlSlqqSM79rNyv+jRJthuCssKt8RAAAAAAAAAAATScL2AAi52wABOIAAAAAAAAAAAAAAAAAAAAADA96mLwAAAAAAAAAAdXTZPts/p6OWtwqrt7gXvO8y5ejC1yhlMgutz1dQhC8AAAAI1YiD7APSSWEAA457AAAABgAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAQAAAAKyQ7QoAAAAAAAAAAAAAAACAAAAAAAAAAAAAAAAAAAAAwAAAAAD3qYvAAAAAGrOQAEAAAAAAAAAAQPepi8AAAAAAAAAAHV02T7bP6ejlrcKq7e4F7zvMuXowtcoZTILrc9XUIQvAAAACNWIg+wD0klhAAOOewAAAAYAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAEAAAACsj8ILwAAAAAAAAAAAAAAAgAAAAAAAAAAAAAAAAAAAAMAAAAAA96mLwAAAABqzkABAAAAAAAAAAMD3qYtAAAAAQAAAAB1dNk+2z+no5a3Cqu3uBe87zLl6MLXKGUyC63PV1CELwAAAAFYUlAAAAAAAG8Xr51rziqwpQYzWlSlqqSM79rNyv+jRJthuCssKt8RAAAAAdCBezxiK0gms0H/oAAAAAEAAAABAAAAAAAAAAAAAAAAYHK3WQAAAAAAAAAAAAAAAQPepi8AAAABAAAAAHV02T7bP6ejlrcKq7e4F7zvMuXowtcoZTILrc9XUIQvAAAAAVhSUAAAAAAAbxevnWvOKrClBjNaVKWqpIzv2s3K/6NEm2G4Kywq3xEAAAAB0IF7PGIrSCazQf+gAAAAAQAAAAEAAAAAAAAAAAAAAABgcmvgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAABJbT82FmuwvpjSEOMSJs8PBDJi20hvk/TyzDLaJU++XcAAAABAAAAAAAAAAIAAAAPAAAAA2ZlZQAAAAASAAAAAAAAAAB1dNk+2z+no5a3Cqu3uBe87zLl6MLXKGUyC63PV1CELwAAAAoAAAAAAAAAAAAAAAAAAABkAAAAAA==",
"events": {
"transactionEventsXdr": [
"AAAAAAAAAAAAAAABJbT82FmuwvpjSEOMSJs8PBDJi20hvk/TyzDLaJU++XcAAAABAAAAAAAAAAIAAAAPAAAAA2ZlZQAAAAASAAAAAAAAAAB1dNk+2z+no5a3Cqu3uBe87zLl6MLXKGUyC63PV1CELwAAAAoAAAAAAAAAAAAAAAAAAABk"
],
"contractEventsXdr": [
[]
]
},
"ledger": 64923183,
"createdAt": 1791901697
}
],
"latestLedger": 64923230,
"latestLedgerCloseTimestamp": 1791901932,
"oldestLedger": 63886431,
"oldestLedgerCloseTimestamp": 1786359079,
"cursor": "278842947737227265"
}
}