Get Transaction Status

Retrieve the status of a transaction by chain and transaction hash. Supports EVM, Solana, and Bitcoin.

Endpoint: GET /api/v1/status/transaction/{txHash} Auth: Required (Authorization: Bearer YOUR_API_KEY)

Path parameters

Parameter	Type	Required	Description
txHash	string	Yes	Transaction hash

Query parameters

Parameter	Type	Required	Description	Example
chainRef	string	Yes	Chain identifier. Required query parameter.	eth-mainnet

Example

cURL

curl -X GET 'https://api.gateway.zert.com/api/v1/status/transaction/0x123...?chainRef=eth-mainnet' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "data": {
    "txHash": "0x123...",
    "chain": "eth-mainnet",
    "status": "confirmed",
    "confirmedAtMs": 1745400000000
  },
  "meta": {
    "requestId": "req_xyz",
    "timestamp": "2026-04-23T12:00:00.000Z"
  }
}

Transaction status values

Status	Description
pending	Transaction submitted, not yet confirmed
confirmed	Transaction confirmed on chain
failed	Transaction failed

Responses

Code	Description
200	Transaction status found
400	Missing or invalid chainRef
401	Unauthorized (missing or invalid API key)
404	Transaction not found
502	Upstream error

Zert APIsapi.gateway.zert.com

Zert API — Transaction Status