getSignatureStatuses

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

Parameters

Signatures array<string>

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

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> - This will always be "finalized"
    • DEPRECATED: status: <object> - Transaction status
    • "Ok": <null> - Transaction was successful
    • "Err": <ERR> - Transaction failed with TransactionError

Code sample

curl "https://testnet.atlas.xyz/?apikey=$ATLAS_API_KEY" -X POST -H "Content-Type: application/json" -d '
{
  "jsonrpc": "2.0",
  "id": "0bdba4c1-3073-41b0-b849-46f14e004e38",
  "method": "getSignatureStatuses",
  "params": [
    [
        "4Gzhopapgc1Tu9TAvPuWCFZbLWqHJ7Yrsa6jMiC4NvKS6XPG2396bTeywmXrzEDmRNiU6vqhZMDWn9Sxg6rsCKQR"
    ],
    {
        "searchTransactionHistory": true
    }
  ]
}
'

Response

{
  "jsonrpc": "2.0",
  "id": "0bdba4c1-3073-41b0-b849-46f14e004e38",
  "result": {
    "context": {
      "slot": 11137206
    },
    "value": [
      {
        "slot": 11137064,
        "confirmations": null,
        "status": {
          "Ok": null
        },
        "err": null,
        "confirmationStatus": "finalized"
      }
    ]
  }
}