---
title: "Get all client intents"
method: GET
path: "/intents"
tags: ["Intents"]
---

# Get all client intents

`GET /intents`

Retrieves all intents for the authenticated client with pagination and optional status filtering

## Query parameters

- `limit` number
- `offset` number
- `status` 'pending' | 'processing' | 'completed' | 'failed'

## Response `200`

List of intents retrieved successfully

- object
  - `intents` object[]
    - `id` number
    - `client_id` string
    - `sender` string
    - `initialAmount` string
    - `fees_in_usd` string
    - `app_fee_in_usd` string
    - `total_amount_in_usd` string
    - `total_amount_in_asset_token` string
    - `fees_in_asset_token` string
    - `app_fee_in_asset_token` string
    - `asset_token_symbol` string
    - `asset_token_decimals` number
    - `slippage` string
    - `tokenIn` string
    - `tokenOut` string
    - `intent_address` string
    - `destination_intent_address` string
    - `source_chain` string
    - `destination_chain` string
    - `recipient` string
    - `refund_address` string
    - `relayer` string
    - `coordinator` string
    - `bridger` string
    - `bridgeExtraData` string
    - `intent_nonce` number
    - `intent_status` 'PENDING' | 'FUNDED' | 'INITIATED' | 'COMPLETED' | 'EXPIRED'
    - `tx_hash` string, nullable
    - `needs_relay` boolean
    - `relayer_claimed` boolean
    - `paymaster_used` boolean
    - `mode` 'test' | 'live'
    - `expires_at` string, date-time
    - `metadata` object
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `total` number
  - `limit` number
  - `offset` number

## Other responses

- `401` — Unauthorized - Invalid or missing API key

## Changes

- **2026-02-17** `2168c5f4fdd5` — 2 warning, 9 info
  - removed the optional property `intents/items/fees` from the response with the `200` status
  - removed the optional property `intents/items/totalAmount` from the response with the `200` status
  - added the optional property `intents/items/app_fee_in_asset_token` to the response with the `200` status
  - added the optional property `intents/items/app_fee_in_usd` to the response with the `200` status
  - …7 more
- **2025-12-13** `0172b83f90c7` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `401`
- **2025-11-11** `fce39ccb3e9d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/horuslabsio/apis/chainrails-api/changes/intents/get.md)

---

[API](https://skmtc.dev/horuslabsio/apis/chainrails-api.md) · [All operations](https://skmtc.dev/horuslabsio/apis/chainrails-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/horuslabsio/chainrails-api/revisions/dcf19c1bab20/schema)