Get transaction status - TRAIT DataGate API

Request

Body Params application/json

Request params for the endpoint `/tx/status`.

tx_hash

string

Tx Hash

required

Hash of the transaction.

>= 66 characters<= 66 characters

Match pattern:

^0x[0-9abcdefABCDEF]{64}$

Example

{
    "tx_hash": "0xc1d7544a525266f3fe5aada8ffd57f9bcf2b35ed6e276044ab92c6fb68267781"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.trait.tech/tx/status' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tx_hash": "0xc1d7544a525266f3fe5aada8ffd57f9bcf2b35ed6e276044ab92c6fb68267781"
}'

Responses

🟢200OK

application/json

Successful Response

Body

Response schema for the endpoint `/tx/status`.

metadata

object (ResponseMetadata)

required

Metadata for the generated response.

request_context

object (ResponseBlockId)

required

For the endpoints with historical data: the last block, the data from which is included in the response. For the endpoints with blockchain state data: the block whose state is provided in the response. Request context remains the same for all data pages in the series for the initial request.

blockchain_head

object (ResponseBlockId)

required

The latest blockchain block currently available.

data

object (TxStatusInfo)

required

Information about current status of the transaction.

status_code

enum<string>

required

The stage of the processing of transaction by the blockchain.

Allowed values:

IN_TRANSACTION_POOLIN_BLOCKFINALISEDUNKNOWN

status_text

string

Status Text

required

Human-readable text with description of the current status of the transaction.

Example

{
    "metadata": {
        "request_context": {
            "block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
            "block_index": 29702,
            "block_timestamp": 1727581488000
        },
        "blockchain_head": {
            "block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
            "block_index": 29702,
            "block_timestamp": 1727581488000
        }
    },
    "data": {
        "status_code": "FINALISED",
        "status_text": "Transaction included into the blockchain"
    }
}

🟠422Parameter Error