getSignatureStatuses

Check whether Solana transaction signatures have landed, and at what commitment, over rpc edge.

getSignatureStatuses reports the confirmation state of one or more transaction signatures. After sendTransaction returns a signature, poll this to know whether the transaction actually landed and whether it succeeded.

Request

curl -s https://rpc.rpcedge.com \
  -H 'content-type: application/json' \
  -H 'x-api-key: YOUR_UUID_KEY' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignatureStatuses",
    "params": [["5VERv8...signature...9nT"], { "searchTransactionHistory": false }]
  }'

Parameters

PositionNameTypeNotes
0signaturesstring[]Up to 256 base-58 signatures.
1configobjectOptional. searchTransactionHistory (bool) also searches older history - slower, off by default.

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "context": { "slot": 429641447 },
    "value": [
      { "slot": 429641440, "confirmations": 7, "err": null, "confirmationStatus": "confirmed" }
    ]
  }
}

value is aligned to your input order; each element is null if the signature is unknown (not yet seen, or aged out of the recent cache when searchTransactionHistory is false).

FieldMeaning
slotSlot the transaction was processed in.
confirmationsBlocks since processing, or null once finalized.
errnull if the transaction succeeded; otherwise the on-chain error.
confirmationStatusprocessed | confirmed | finalized.
getSignatureStatuses · rpc edge docs