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 finalized slots.

Updated on
Oct 21, 2026
Please note that for this RPC method, the array size is limited to 5 for Free Trial plans and 1005 for all paid accounts, 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
object

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
number or null

null when finalized. Non-finalized transactions can return 0 under Alpenglow; this field is not a TowerBFT confirmation-depth counter

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
Response
1
{
2
"jsonrpc": "2.0",
3
"result": {
4
"context": {
5
"apiVersion": "2.1.16",
6
"slot": 335501862
7
},
8
"value": [
9
{
10
"confirmationStatus": "finalized",
11
"confirmations": null,
12
"err": null,
13
"slot": 140512999,
14
"status": {
15
"Ok": null
16
}
17
},
18
{
19
"confirmationStatus": "finalized",
20
"confirmations": null,
21
"err": null,
22
"slot": 139665040,
23
"status": {
24
"Ok": null
25
}
26
}
27
]
28
},
29
"id": 1
30
}
1
{
2
"jsonrpc": "2.0",
3
"result": {
4
"context": {
5
"apiVersion": "2.1.16",
6
"slot": 335501862
7
},
8
"value": [
9
{
10
"confirmationStatus": "finalized",
11
"confirmations": null,
12
"err": null,
13
"slot": 140512999,
14
"status": {
15
"Ok": null
16
}
17
},
18
{
19
"confirmationStatus": "finalized",
20
"confirmations": null,
21
"err": null,
22
"slot": 139665040,
23
"status": {
24
"Ok": null
25
}
26
}
27
]
28
},
29
"id": 1
30
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free