Get Settle Status

Get the on-chain settlement status for an x402 transaction

GET /api/v1/x402/settle/{tx_id}

Get settle status

cURL

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

200

{
  "success": true,
  "txId": "<string>",
  "status": "<string>",
  "network": "<string>",
  "txHash": "<string>"
}

Get Settle Status

Retrieve the on-chain settlement status for an x402 transaction. Poll this endpoint after POST /x402/settle to track the broadcast and confirmation progress.

tx_id · string · required

Transaction ID returned by POST /x402/settle.

Response

{
  "success": true,
  "txId": "7f9da3de-5899-43c6-8104-b96187df024f",
  "status": "CONFIRMED",
  "txHash": "0xabcdef1234567890...",
  "network": "base"
}

Field	Type	Description
success	boolean	Whether the settlement is successful
txId	string	Settlement transaction ID
status	string	PENDING, BROADCAST, CONFIRMED, FAILED
txHash	string	On-chain transaction hash (present after broadcast)
network	string	Gateway field currently populated from the settle transaction’s chain value

Errors

HTTP	Code	Condition
400	invalid_parameter	Missing transaction ID
404	not_found	Settle transaction not found
500	internal_error	Internal processing failure

Authorizations

Authorization · string · header · required

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

Path Parameters

tx_id · string · required

Settlement transaction ID returned by POST /api/v1/x402/settle.

Response

200

application/json

Settlement status.

success · boolean · required

txId · string · required

status · string · required

network · string · required

txHash · string