getSignatureStatuses RPC Method

Returns the statuses of a list of signatures. Each signature must be a txid, the first signature of a transaction.


Unless the searchTransactionHistory configuration parameter is included, this method only searches the recent status cache of signatures, which retains statuses for all active slots plus MAX_RECENT_BLOCKHASHES rooted slots.

Parameters #

array required

An array of transaction signatures to confirm, as base-58 encoded strings (up to a maximum of 256)

object optional

Configuration object containing the following fields:

searchTransactionHistory bool optional

if true - a Solana node will search its ledger cache for any signatures not found in the recent status cache

Result #

An array of RpcResponse<object> consisting of either:

  • <null> - Unknown transaction, or
  • <object>
    • slot: <u64> - The slot the transaction was processed
    • confirmations: <usize|null> - Number of blocks since signature confirmation, null if rooted, as well as finalized by a supermajority of the cluster
    • err: <object|null> - Error if transaction failed, null if transaction succeeded. See TransactionError definitions
    • confirmationStatus: <string|null> - The transaction's cluster confirmation status; Either processed, confirmed, or finalized. See Commitment for more on optimistic confirmation.
    • DEPRECATED: status: <object> - Transaction status
      • "Ok": <null> - Transaction was successful
      • "Err": <ERR> - Transaction failed with TransactionError

Code sample #

curl -X POST -H "Content-Type: application/json" -d '
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignatureStatuses",
    "params": [
        "searchTransactionHistory": true

Response #

  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 82
    "value": [
        "slot": 48,
        "confirmations": null,
        "err": null,
        "status": {
          "Ok": null
        "confirmationStatus": "finalized"
  "id": 1