Skip to main content
GET
/
v1
/
transactions
Error
A valid request URL is required to generate request examples
{
  "transactions": [
    {
      "signature": {
        "value": "aSDinaTvuI8gbWludGxpZnk="
      },
      "header": {
        "feePayerSignature": {
          "value": "aSDinaTvuI8gbWludGxpZnk="
        },
        "version": 123,
        "flags": 123,
        "readwriteAccountsCount": 123,
        "readonlyAccountsCount": 123,
        "instructionDataSize": 123,
        "requestedComputeUnits": 123,
        "requestedStateUnits": 123,
        "requestedMemoryUnits": 123,
        "expiryAfter": 123,
        "fee": "<string>",
        "nonce": "<string>",
        "startSlot": "<string>",
        "feePayerPubkey": {
          "value": "aSDinaTvuI8gbWludGxpZnk="
        },
        "programPubkey": {
          "value": "aSDinaTvuI8gbWludGxpZnk="
        }
      },
      "body": "aSDinaTvuI8gbWludGxpZnk=",
      "executionResult": {
        "consumedComputeUnits": 123,
        "consumedMemoryUnits": 123,
        "consumedStateUnits": 123,
        "userErrorCode": "<string>",
        "vmError": "TRANSACTION_VM_EXECUTE_SUCCESS",
        "executionResult": "<string>",
        "pagesUsed": 123,
        "eventsCount": 123,
        "eventsSize": 123,
        "readwriteAccounts": [
          {
            "value": "aSDinaTvuI8gbWludGxpZnk="
          }
        ],
        "readonlyAccounts": [
          {
            "value": "aSDinaTvuI8gbWludGxpZnk="
          }
        ],
        "events": [
          {
            "eventId": "<string>",
            "callIdx": 123,
            "programIdx": 123,
            "program": {
              "value": "aSDinaTvuI8gbWludGxpZnk="
            },
            "payload": "aSDinaTvuI8gbWludGxpZnk="
          }
        ]
      },
      "slot": "<string>",
      "blockOffset": 123
    }
  ],
  "page": {
    "nextPageToken": "<string>",
    "totalSize": "<string>"
  }
}

Query Parameters

​
filter.expression
string

CEL expression applied server-side. Empty expressions are treated as no-op.

​
page.pageSize
integer<int64>

Maximum number of items to return in a single response.

​
page.pageToken
string

Token identifying the position to resume from.

​
page.orderBy
string

Optional ordering specification in "field [asc|desc]" form.

​
returnEvents
boolean

Whether to include event data in results (default: false)

​
versionContext.slot
string<uint64>

Request the version for a specific slot number.

​
versionContext.timestamp
string<date-time>

Request the version nearest to the provided block timestamp.

​
versionContext.seq
string<uint64>

Request the version for a specific seq number. Relevant only for GetAccount and GetRawAccount requests.

​
minConsensus
enum<string>
default:CONSENSUS_STATUS_UNSPECIFIED
  • CONSENSUS_STATUS_UNSPECIFIED: CONSENSUS_STATUS_UNSPECIFIED indicates the consensus status is unknown.
  • CONSENSUS_STATUS_OBSERVED: CONSENSUS_STATUS_OBSERVED indicates the resource has been observed but not yet confirmed in a finalized block.
  • CONSENSUS_STATUS_INCLUDED: CONSENSUS_STATUS_INCLUDED indicates the resource has been included in the ledger but may not be finalized.
  • CONSENSUS_STATUS_FINALIZED: CONSENSUS_STATUS_FINALIZED indicates the resource is finalized for a slot.
  • CONSENSUS_STATUS_LOCALLY_EXECUTED: CONSENSUS_STATUS_LOCALLY_EXECUTED indicates the local node executed the resource but broader cluster finality may not have been achieved.
  • CONSENSUS_STATUS_CLUSTER_EXECUTED: CONSENSUS_STATUS_CLUSTER_EXECUTED indicates the entire cluster has executed and agreed on the resource.
Available options:
CONSENSUS_STATUS_UNSPECIFIED,
CONSENSUS_STATUS_OBSERVED,
CONSENSUS_STATUS_INCLUDED,
CONSENSUS_STATUS_FINALIZED,
CONSENSUS_STATUS_LOCALLY_EXECUTED,
CONSENSUS_STATUS_CLUSTER_EXECUTED

Response

A successful response.

ListTransactionsResponse returns paginated executed transactions.

​
transactions
object[]
​
page
object

PageResponse captures pagination metadata returned with list results.