Get transaction status

GET /api/tx

Fetch the current record for a submitted transaction by its id. The includeReceipt and includeRevertInfo flags are string-valued query parameters - pass the string "true" or "1" to enable them; any other value (or omitting them) leaves the receipt and revert fields out of the response. This endpoint requires no authentication.

Parameters

Name	In	Type	Required	Description
id	query	string	yes	The transaction id returned at submission time.
includeReceipt	query	string	no	Pass the string "true" or "1" to include the on-chain receipt in the record's receipt field. Any other value disables it.
includeRevertInfo	query	string	no	Pass the string "true" or "1" to include revert details for failed transactions in the record's revert field. Any other value disables it.

Responses

Status	Description
200	The transaction record.
400	Invalid request. Plausible codes: VALIDATION_004 (the id parameter is missing or empty).
404	No transaction with this id. Plausible codes: TRANSACTION_003.
500	Server error. Plausible codes: SYSTEM_001.

200 response

{
  "success": true,
  "data": {
    "id": "68fa3450539a3c9d28bbca33",
    "userId": "68c275846a6ba1c9a2198a8c",
    "to": "0x3dbE34f2C21b3B2980d4dc53f3c7E51e39663F49",
    "callData": "0x",
    "value": "1",
    "chainId": 8453,
    "gasPrice": null,
    "maxFeePerGas": null,
    "maxPriorityFeePerGas": null,
    "gasLimit": "21000",
    "label": "My Base Transaction",
    "status": "EXECUTED",
    "executionTxHash": "0x8b6d34f1a2c05e97d0c1b28fe6a4a1c9e3b7d20a54f8c96e1d3a5b7c9e0f2a4b",
    "timestamp": "2026-07-29T12:34:56.789Z",
    "latency": 2500,
    "costUSD": 0.84,
    "retries": 0,
    "isAccountCharged": true,
    "transactionType": "flash",
    "submitRegion": "default"
  },
  "timestamp": "2026-07-29T12:35:00.101Z"
}

400 response

{
  "success": false,
  "error": {
    "code": "VALIDATION_004",
    "message": "`id` is required",
    "category": "VALIDATION",
    "traceId": "6f2c1e0a-8b4d-4c1e-9f3a-2d5b7c8e9a01"
  },
  "timestamp": "2026-07-29T12:34:56.789Z"
}

404 response

{
  "success": false,
  "error": {
    "code": "TRANSACTION_003",
    "message": "Transaction not found",
    "category": "TRANSACTION",
    "traceId": "6f2c1e0a-8b4d-4c1e-9f3a-2d5b7c8e9a01"
  },
  "timestamp": "2026-07-29T12:34:56.789Z"
}

500 response

{
  "success": false,
  "error": {
    "code": "SYSTEM_001",
    "message": "Database operation failed",
    "category": "SYSTEM",
    "traceId": "6f2c1e0a-8b4d-4c1e-9f3a-2d5b7c8e9a01"
  },
  "timestamp": "2026-07-29T12:34:56.789Z"
}