---
title: "POST /get_transaction_status"
method: POST
path: "/get_transaction_status"
---

# POST /get_transaction_status

`POST /get_transaction_status`

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.

## Request body

- object
  - `id` string, required — The transaction ID of the transaction to retrieve the status for.

## Response `200`

OK

- TransactionStatus
  - `state` string, required — The state of the transaction. Possible values: LOCALLY_APPLIED, FORKED_OUT, IN_BLOCK, IRREVERSIBLE, FAILED, UNKNOWN.
  - `block_number` integer — The transaction block number.
  - `block_id` string
  - `block_timestamp` string — Date/time string in the format YYYY-MM-DDTHH:MM:SS
  - `expiration` string — Date/time string in the format YYYY-MM-DDTHH:MM:SS.sss
  - `head_number` integer, required — The head block number.
  - `head_id` string, required
  - `head_timestamp` string, required — Date/time string in the format YYYY-MM-DDTHH:MM:SS
  - `irreversible_number` integer, required — The irreversible block number.
  - `irreversible_id` string, required
  - `irreversible_timestamp` string, required — Date/time string in the format YYYY-MM-DDTHH:MM:SS
  - `last_tracked_block_id` string, required

---

[API](https://skmtc.net/worldwide-asset-exchange/apis/chain-api.md) · [All operations](https://skmtc.net/worldwide-asset-exchange/apis/chain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/worldwide-asset-exchange/chain-api/revisions/5bfa22186461/schema)