Skip to main content
GET
/
intents
Get all client intents
curl --request GET \
  --url https://api.chainrails.io/api/v1/intents \
  --header 'Authorization: Bearer <token>'
{
  "intents": [
    {
      "id": 1,
      "client_id": "e1ee3675-cb26-4a76-8206-a84f86e85862",
      "sender": "0xdA3ECb2E5362295E2b802669dD47127A61d9Ce54",
      "initialAmount": "1000000",
      "fees": "10500",
      "totalAmount": "1010500",
      "tokenIn": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "tokenOut": "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d",
      "intent_address": "0x4E60e01263E750eD9D087157e19D2480Fd86A900",
      "destination_intent_address": "0x5F70e12374E750fE0E087158f29E3591Ge97B011",
      "source_chain": "BASE_TESTNET",
      "destination_chain": "ARBITRUM_TESTNET",
      "recipient": "0xb79541Be080a59fdcE6C0b43219ba56c725eC65e",
      "refund_address": "0xb79541Be080a59fdcE6C0b43219ba56c725eC65e",
      "relayer": "",
      "coordinator": "0x989f47053F188778575113DcF39dB8960Fc450e2",
      "bridger": "0xa1c943058a631D5506eb7d96036eAbF6968e2338",
      "bridgeExtraData": "0x00000000000000000000000000000000000000000000000000000000000001f4",
      "intent_nonce": 4267684716645197,
      "intent_status": "PENDING",
      "tx_hash": null,
      "needs_relay": false,
      "relayer_claimed": false,
      "paymaster_used": false,
      "mode": "test",
      "expires_at": "2025-12-13T03:31:23.000Z",
      "metadata": {
        "orderId": "12345"
      },
      "created_at": "2025-12-13T02:31:23.390Z",
      "updated_at": "2025-12-13T02:31:23.390Z"
    }
  ],
  "total": 100,
  "limit": 50,
  "offset": 0
}

Authorizations

Authorization
string
header
required

Enter your Chainrails API key as a Bearer token

Query Parameters

limit
number

Number of intents to return (default: 50, max: 100)

offset
number

Number of intents to skip (default: 0)

status
enum<string>

Filter by intent status

Available options:
pending,
processing,
completed,
failed

Response

List of intents retrieved successfully

intents
object[]
total
number
Example:

100

limit
number
Example:

50

offset
number
Example:

0