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
Dec 7, 2023

getSignatureStatuses RPC Method

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