GET /status

GET https://api.trustware.io/api/v1/route-intent/:intentId/status Poll this endpoint after submitting the receipt to track routing and settlement progress through to completion. The metadata field echoes exactly what you passed in the POST /route call, so use it to attribute the transaction to the correct user or internal record. Poll until status reaches success or failed.

Path parameters

Parameter	Description
`intentId`	The `intentId` returned by `POST /route`.

Response

{
  "data": {
    "id": "bc5a5e82-1ecb-453b-bf78-c7c3ccdc3223",
    "intent_id": "d9a10f42-7243-498d-914a-269a18b93660",
    "sdk_request": true,
    "from_address": "0xeb212fe20f26243ec4d4df2dd49c8aa9fa75a201",
    "to_address": "0xeb212fe20f26243ec4d4df2dd49c8aa9fa75a201",
    "from_chain_id": "43114",
    "to_chain_id": "137",
    "source_tx_hash": "0x4c8f91363c5f5e3ac2154f94995f5beac2993cc595af552c2681538af627e05d",
    "dest_tx_hash": "0x9b7e3f0a...",
    "request_id": "eeaa53a4f2e254896ae690edac309e68",
    "status": "bridging",
    "routing_provider": "squid",
    "quote_to_amount_usd": "0.19000000",
    "to_amount_wei": "198584",
    "poll_attempt": 1,
    "next_poll_at": "2026-04-15T03:13:54.289994Z",
    "create_date": "2026-04-15T03:13:22.592483Z",
    "update_date": "2026-04-15T03:13:24.290292Z"
  }
}

Status values

The status field on the response is one of four values:

`status`	Meaning
`submitted`	The receipt has been submitted; tracking has started. Continue polling.
`bridging`	Assets are in transit to the destination chain. Continue polling.
`success`	Route completed successfully. Final amounts and destination hash are available.
`failed`	The route failed. If funds moved on the source chain, a refund has been initiated back to the source address.

If intentId is unknown or no receipt has been submitted yet, the endpoint returns HTTP 404 Not Found rather than a status value.

Auxiliary status fields

A few separate fields surface conditions that are not part of the main status enum:

Field	Meaning
`gas_status`	Set to `"needs_gas"` when the destination chain step stalled due to insufficient gas. Present only when relevant.
`routing_provider`	The routing provider used for this route, as a runtime value such as `"squid"` or `"lifi"`. Useful when triaging a `failed` status.

Response fields

Field	Description
`id`	Trustware internal transaction record ID.
`intent_id`	The `intentId` from the route response.
`sdk_request`	`true` when the intent originated from a Trustware SDK API key.
`from_address`	Source wallet address.
`to_address`	Destination wallet address.
`from_chain_id`	Source chain ID.
`to_chain_id`	Destination chain ID.
`source_tx_hash`	Transaction hash on the source chain.
`dest_tx_hash`	Transaction hash on the destination chain. Populated once the route settles.
`status`	Current status. One of `submitted`, `bridging`, `success`, `failed`.
`routing_provider`	Routing provider used for this route, as a runtime value such as `"squid"` or `"lifi"`.
`quote_to_amount_usd`	Expected destination USD value from the quote.
`to_amount_wei`	Destination token amount received (in smallest unit). Populated on `success`.
`gas_status`	Optional. Surfaces conditions such as `"needs_gas"` when the destination step stalls.
`poll_attempt`	Number of times this intent has been polled.
`next_poll_at`	Suggested timestamp for the next poll.
`create_date`	When the intent record was created (ISO 8601).
`update_date`	When the status was last updated (ISO 8601).

Polling guidance

Use next_poll_at as the suggested time for your next request rather than a fixed interval. This avoids unnecessary requests while the route is in transit. On failed status: if the source chain transaction confirmed but the route failed, Trustware initiates a refund to the source address. Your application should not trigger any downstream payout until success is confirmed.

The status endpoint will become a WebSocket stream in a future release. The polling interface will remain supported.

Getting Started

Endpoints

Path parameters

Response

Status values

Auxiliary status fields

Response fields

Polling guidance

​Path parameters

​Response

​Status values

​Auxiliary status fields

​Response fields

​Polling guidance

Path parameters

Response

Status values

Auxiliary status fields

Response fields

Polling guidance