Get Transaction

Get transaction details by ID

GET /api/v1/transactions/{id}

Get transaction

cURL

curl --request GET \
  --url https://api.paratro.com/api/v1/transactions/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "tx_id": "tx_w1x2y3z4a5",
  "wallet_id": "wal_a1b2c3d4e5f6",
  "client_id": "cli_x1y2z3",
  "chain": "ethereum",
  "transaction_type": "OUTBOUND",
  "from_address": "0x1234567890abcdef1234567890abcdef12345678",
  "to_address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
  "token_symbol": "USDT",
  "amount": "100.00",
  "status": "CONFIRMED",
  "created_at": "2026-01-15T11:00:00Z",
  "tx_hash": "0xabc123def456789..."
}

Get Transaction

Retrieve details of a specific transaction, including on-chain status.

id · string · required

Transaction ID.

Response

{
  "tx_id": "tx_01HXYZ...",
  "wallet_id": "w_01HXYZ...",
  "client_id": "c_01HXYZ...",
  "chain": "ethereum",
  "transaction_type": "OUTBOUND",
  "from_address": "0xaaaa...",
  "to_address": "0xbbbb...",
  "token_symbol": "USDT",
  "amount": "100.50",
  "status": "CONFIRMED",
  "tx_hash": "0xabcdef...",
  "created_at": "2025-01-15T10:30:45+08:00"
}

Field	Type	Description
transaction_type	string	Gateway transaction type, for example OUTBOUND, X402_SIGN, or X402_SETTLE
amount	string	Transaction amount (decimal string)
status	string	Gateway transaction status; values depend on the transaction type
tx_hash	string	On-chain transaction hash (empty if not yet broadcast)

Errors

HTTP	Code	Condition
400	invalid_parameter	Missing transaction ID
404	not_found	Transaction not found

Authorizations

Authorization · string · header · required

JWT access token obtained from the /api/v1/auth/token endpoint.

Path Parameters

id · string · required

The unique identifier of the transaction.

Response

200

application/json

Transaction retrieved successfully.

tx_id · string · required

Unique identifier for the transaction.

Example:

"tx_w1x2y3z4a5"

wallet_id · string · required

The wallet ID associated with this transaction.

Example:

"wal_a1b2c3d4e5f6"

client_id · string · required

The client ID that initiated this transaction.

Example:

"cli_x1y2z3"

chain · string · required

Transaction chain returned by the gateway.

Example:

"ethereum"

transaction_type · string · required

Transaction type returned by the gateway, for example TRANSFER, X402_SIGN, or X402_SETTLE.

Example:

"OUTBOUND"

from_address · string · required

The sender's blockchain address.

Example:

"0x1234567890abcdef1234567890abcdef12345678"

to_address · string · required

The recipient's blockchain address.

Example:

"0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"

token_symbol · string · required

The symbol of the transferred token.

Example:

"USDT"

amount · string · required

The amount transferred.

Example:

"100.00"

status · string · required

Transaction status returned by the gateway. Values depend on the transaction type.

Example:

"CONFIRMED"

created_at · string<date-time> · required

Timestamp when the transaction was created.

Example:

"2026-01-15T11:00:00Z"

tx_hash · string | null

The on-chain transaction hash. Null while the transaction is pending.

Example:

"0xabc123def456789..."