Endpoints

Poll order status

Check an order every few seconds and stop when final is true.

GET/cloak/v1/status/:trackingId

Examples in

Unknown orders and orders belonging to another account are indistinguishable: both return 404 ORDER_NOT_FOUND.

Request

curl -sS "https://api.veilo.network/cloak/v1/status/TRACKING_ID" \
  -H "Authorization: Bearer $VEILO_KEY"

Response

200 · application/json

{
  "success": true,
  "order": {
    "trackingId":         "TRACKING_ID",
    "status":             "ANONYMIZING",
    "final":              false,
    "detailedStatus":     "queued_payout",   // use status for application logic
    "amountIn":       "10091009518",
    "amountOut":      "10000000000",
    "sourceSymbol":       "USDC",
    "destinationSymbol":  "USDC",
    "depositTxSignature": "<sig>",
    "payoutTxSignature":  null,
    "updatedAt":          "2026-08-26T11:25:00.000Z"
  }
}

Build logic around status

status is the stable value for application logic. Use detailedStatus only for display, logs, or support because new values may be added. See Order lifecycle.

Polling well

Poll every few seconds. These requests use your read budget, which is separate from order creation. Stop when final is true.