> For the complete documentation index, see [llms.txt](https://docs.blockz.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockz.fi/api/submit-intent/intent-status.md).

# Intent Status

Retrieve the current status of a swap intent.

This endpoint returns the intent lifecycle state, associated transaction references, and execution metadata.

```http
GET /affiliate/v1/intents/{intent_id}/status
```

**Response example**

```json
{
  "intent_id": "fe5601fb-60f2-4cb0-8a67-c55bd3640411",
  "status": "UserDeposited",
  "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",
    "kyc_requested_at": null,
    "fulfilled_at": null,
    "swapped_at": null,
    "refunded_at": null
  },
  "source_amount_decimals": 18,
  "source_amount_lots": "123456",
  "source_chain": 1,
  "source_token": "0x000000000000000000000000000000000000000",
  "dest_amount_decimals": 6,
  "dest_chain": 2,
  "dest_token": "0x000000000000000000000000000000000000000",
  "min_dest_amount_lots": "123456",
  "max_dest_amount_lots": "123456"
}
```

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

#### Possible swap statuses

| Status           | Description                                                           |
| ---------------- | --------------------------------------------------------------------- |
| `Initiated`      | The intent has been created but no approval has been added yet.       |
| `ApprovalAdded`  | User has added approval/signature for the swap.                       |
| `Accepted`       | Resolver has accepted the intent and is ready to execute.             |
| `Declined`       | The intent was declined by the resolver                               |
| `UserDeposited`  | Resolver has deposited user tokens on source network into the escrow. |
| `Fulfilled`      | User has received funds on destination network in target token        |
| `Expired`        | The intent expired before execution.                                  |
| `RefundRquested` | A refund has been requested for this intent.                          |
| `Refunded`       | Tokens have been refunded to the user.                                |

**Additional notes**

* This endpoint can be used to poll the execution status of an intent.
* `swap_metadata` includes transaction hashes and timestamps that correspond to each stage of the swap lifecycle.