Intent Status

This endpoint allows you to check the current status of a swap intent. It provides the intent's lifecycle state, associated transactions, and additional metadata.

HTTP request

GET /v1/intents/{intent_id}

Request

Header parameters

Requires authentification.

Query paramaters

Name	Type	Required	Description
intent_id	String	True	Swap intent ID.

Body parameters

Doesn't require setting any parameters.

Response

Sample response

application/json

{
  "intent_id": "fe5601fb-60f2-4cb0-8a67-c55bd3640411",
  "status": "Deposited",
  "from_amount_lots": "123456",
  "from_network_id": 1,
  "from_token": "0x000000000000000000000000000000000000000",
  "from_token_id": 1,
  "to_network_id": 2,
  "to_token": "0x000000000000000000000000000000000000000",
  "to_token_id": 4,
  "to_min_amount_lots": "123456",
  "to_max_amount_lots": "123456",
  "swap_metadata": {
    "id": "19b44362-bc4d-4b2e-824f-f712c6c80eff",
    "proxy_address": "0x000000000000000000000000000000000000000",
    "user_deposit_tx": "0x000000000000000000000000000000000000000",
    "fulfill_tx": null,
    "swap_tx": null,
    "created_at": "2026-01-15T12:00:00Z",
    "user_deposited_at": "2026-01-15T12:05:00Z",
    "fulfilled_at": null,
    "swapped_at": null,
    "refunded_at": null
  }
}

Error response

Check the error response schema.

Possible swap statuses

The status field represents the overall progress of the swap, combining both intent and swap state.

Status	Description
Created	The intent has been created but no approval has been added yet.
Approved	User has added approval/signature for the swap.
Verified	Resolver has accepted the intent and is ready to execute.
Failed	The intent was declined by the resolver.
Deposited	Resolver has deposited user tokens on source network into the escrow.
Finished	User has received funds on destination network in target token.
Expired	The intent expired before execution.
Refunded	Tokens have been refunded to the user.

info

• Use this endpoint to poll the status of an intent or check its progress.
• swap_metadata provides transaction hashes and timestamps to track each stage.

---