Sign in

v1

latestOpenAPI 3.0.0raw.githubusercontent.com2025-08-29295183.8 KB

Attempts to get current blockchain state and, if available, transaction information given the transaction id. For query to work, the transaction finality status feature must be enabled by configuring the chain plugin with the config option '--transaction-finality-status-max-storage-size-gb' in nodeos.

post/get_transaction_status

Request body

idstring required

The transaction ID of the transaction to retrieve the status for.

Response

OK

statestring required

The state of the transaction. Possible values: LOCALLY_APPLIED, FORKED_OUT, IN_BLOCK, IRREVERSIBLE, FAILED, UNKNOWN.

block_numberinteger

The transaction block number.

block_idstring
block_timestampstring

Date/time string in the format YYYY-MM-DDTHH:MM:SS

expirationstring

Date/time string in the format YYYY-MM-DDTHH:MM:SS.sss

head_numberinteger required

The head block number.

head_idstring required
head_timestampstring required

Date/time string in the format YYYY-MM-DDTHH:MM:SS

irreversible_numberinteger required

The irreversible block number.

irreversible_idstring required
irreversible_timestampstring required

Date/time string in the format YYYY-MM-DDTHH:MM:SS

last_tracked_block_idstring required