getSignatureStatuses

Returns the statuses of a list of signatures. This method uses 160 credits from your daily balance. 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

• txSignatures: (array of strings) [required] - An array of base58 encoded transaction signatures to confirm.
• config: (object) [optional] - Configuration object with the following options:
  • searchTransactionHistory: boolean - If true, the search includes the entire transaction history. If false, the search only includes recent transactions in the latest confirmed block. The default is false.

Returns

result - An object with the following fields:

• context - An object containing the following keys:
  • slot - The slot number of the block that was queried.
  • apiVersion - The API version used for the query.
• value - An array of objects containing the following keys, or null if the signature is not found:
  • confirmationStatus - The transaction's cluster confirmation status. It can either be processed, confirmed, or finalized.
  • confirmations - The number of confirmations a transaction has received. If the transaction is finalized (confirmed at the highest level of commitment), the value will be null.
  • err - Error code if the transaction failed, or null if the transaction succeeds.
  • slot - The slot number in which the transaction was confirmed.
  • status - The processing status of the transaction. It returns Ok if the transaction was successful and Err if the transaction failed.

Example

Replace <YOUR-API-KEY> with your API key.

Request

• curl

curl https://solana-mainnet.infura.io/v3/<YOUR-API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "getSignatureStatuses", "params": [["5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW"], {"searchTransactionHistory": true}]}'

Response

• JSON

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "apiVersion": "2.2.3",
      "slot": 373170033
    },
    "value": [null]
  },
  "id": 1
}