getSignatureStatuses

POSTTransactionsOperator+

Returns the confirmation status of up to 100 transaction signatures.

Try itSends a real request from your browser to the selected region.
POST
/

getSignatureStatuses checks whether transactions landed and how confirmed they are, without returning full transaction bodies. Pass up to 100 signatures to get each one's slot, confirmation count, status and any error, or null if the node has no record of it.

A send-and-confirm flow polls it after sendTransaction until the status is confirmed or finalized, or an error appears, instead of blocking on a subscription.

Plans & rate limitsOperator and above
FreeNot included
Operator50/s
Blade Runner200/s
Nexus500/s

Parameters

params is a JSON array, with values in this order: signatures, config.

1signaturesstring[]required

Up to 100 transaction signatures to check, base-58 encoded.

Maximum: 100
2configobject

Optional configuration.

Show propertiesProperties
searchTransactionHistorybooleandefault: false

When true, also search the node's full retained ledger history, not just its cache of recently processed signatures. Needed to get a result for anything older than the last few minutes.

Result

resultobject

One status per input signature, in order, wrapped with context.

Show propertiesProperties
contextobjectrequired
Show propertiesProperties
slotinteger
apiVersionstring
value(object | null)[]required
Show one ofOne of
Option 1object
Show propertiesProperties
slotintegerrequired

Slot the transaction was processed in.

confirmationsinteger | nullrequired

Number of blocks since confirmation, or null once the transaction is rooted/finalized.

errobject | nullrequired

Null on success; a TransactionError object on failure.

confirmationStatusstring | nullrequired
Allowed values:processedconfirmedfinalizednull
statusobject

Deprecated legacy field mirroring err: {"Ok": null} or {"Err": ...}.

Option 2null

Notes

  • Maximum 100 signatures per call.
  • Without searchTransactionHistory: true, this checks only the node's short-lived recent-status cache; a valid signature older than a few minutes can come back null.
  • confirmations: null means finalized, not unknown; a transaction carries a count only while still working toward finality.
  • Not available on the Free plan.