---
title: "List Intents"
method: GET
path: "/intent-operations"
tags: ["Intents"]
---

# List Intents

`GET /intent-operations`

Retrieves a paginated list of the authenticated client's intents, newest first.

## Query parameters

- `cursor` string — Opaque cursor from a previous response (`pagination.nextCursor`). Omit for the first page.
- `limit` integer — Max items per page (max 100)

## Headers

- `x-api-version` '2026-01.alps', required
- `x-api-key` string, required

## Response `200`

OK

- object — Paginated list of the client’s intents
  - `data` object[], required — Intents on this page, newest first
    - `id` string, required — Intent id — pass to `GET /intents/:id`
    - `status` 'PENDING' | 'COMPLETED' | 'FAILED', required — Overall intent status
    - `fromChains` number[], required — Source chain IDs — one per distinct chain the intent spends on
    - `toChain` number — Destination chain ID
    - `token` string — Intent value token. The token delivered on the destination chain, or the spent token for same-chain intents (which have no persisted delivery).
    - `amount` string — Intent value in base units — delivered on the destination chain, or spent for same-chain intents (which have no persisted delivery; for same-chain swaps this is the input, not the received amount).
    - `account` string, required — Account that submitted the intent
    - `createdAt` number, required — Intent creation time in unix seconds
  - `pagination` object, required — Keyset pagination metadata
    - `nextCursor` string, nullable, required — Pass as `cursor` to fetch the next page; null when no more results.
    - `hasNextPage` boolean, required

## Other responses

- `400` — Validation error
- `403` — API key scope denied
- `500` — Server error

---

[API](https://skmtc.net/rhinestonewtf/apis/rhinestone-orchestrator-api.md) · [All operations](https://skmtc.net/rhinestonewtf/apis/rhinestone-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rhinestonewtf/rhinestone-orchestrator-api/versions/3656a04f8c42/schema)
