getSignatureStatuses
Returns the statuses of a list of signatures.

Parameters

  • <array of base-58 encoded string> - An array of transaction signatures to confirm
  • <object> - (optional) Configuration object containing the following field:
    • searchTransactionHistory: <bool> - if true, a Solana node will search its ledger cache for any signatures not found in the recent status cache

Results

Known Tx
Unknown Tx
  • <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.
    • confirmationStatus: <string | null> - The transaction's cluster confirmation status; either processed, confirmed, or finalized. See Commitment for more on optimistic confirmation.
  • <null> - Unknown transaction

Example

Request

cURL
1
curl --location --request POST 'https://solana-mainnet.g.alchemy.com/v2/alch-demo/' \
2
--header 'Content-Type: application/json' \
3
--data-raw '{
4
"method": "getSignatureStatuses",
5
"jsonrpc": "2.0",
6
"params": [
7
[
8
"28P1gdVq52uEbCHns4EL5DCMjU5PtcBo5M3Gju4FX8DLwjLPDchudttnQapAxYy5dkdVZ6sqa6pvtgC5mbKLqfQA"
9
],
10
{
11
"searchTransactionHistory": true
12
}
13
]
14
}'
Copied!

Response

1
{
2
"jsonrpc": "2.0",
3
"result": {
4
"context": {
5
"slot": 137569378
6
},
7
"value": [
8
{
9
"confirmationStatus": "finalized",
10
"confirmations": null,
11
"err": null,
12
"slot": 137529522,
13
"status": {
14
"Ok": null
15
}
16
}
17
]
18
}
19
}
Copied!