Skip to main content

getSignatureStatuses RPC Method

Returns the statuses of a list of signatures. 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.

Updated on
Sep 20, 2024

getSignatureStatuses RPC Method

Please note that for this RPC method, the array size is limited to 5 for free accounts and 1005 for all paid accounts, including Starters, Growth, and Business plans, subject to the method's maximum array size restrictions.

Parameters

tx signatures
string
An array of transaction signatures to confirm encoded as base-58 strings
object
array
The configuration object with the following fields:
searchTransactionHistory
boolean
(default: false) If true, the search includes the entire transaction history. If false, the search only includes recent transactions in the latest confirmed block

Returns

result
An object with the following fields:
context
The information about the current state of the program
apiVersion
The version of the Solana RPC API to use
slot
An integer representing the slot for which to retrieve the fee calculator
value
A JSON object with the following fields:
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 (i.e., 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 with TransactionError
Request
1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
-X POST \
3
-H "Content-Type: application/json" \
4
--data '{"jsonrpc": "2.0","id": 1,"method": "getSignatureStatuses","params": [["5tGfZLNDxtCtWsW1BJoeTyHvnfGqpADDfBkUgkKENQJ8iz5yTN3ae51j8m8GRFevJx82gyuKnEX7iexFsqf7X2vS","D13jTJYXoQBcRY9AfT5xRtsew7ENgCkNs6mwwwAcUCp4ZZCEM7YwZ7en4tVsoDa7Gu75Jjj2FgLXNUz8Zmgedff"],{"searchTransactionHistory": true}]}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free