> ## Documentation Index > Fetch the complete documentation index at: https://docs.rhinestone.dev/llms.txt > Use this file to discover all available pages before exploring further. # List Intents > Retrieves a paginated list of the authenticated client's intents, newest first. ## OpenAPI ````yaml https://raw.githubusercontent.com/rhinestonewtf/openapi/refs/heads/main/orchestrator/blanc.json get /intents openapi: 3.0.0 info: title: Rhinestone Orchestrator API version: 2026-04.blanc servers: - url: https://v1.orchestrator.rhinestone.dev security: [] paths: /intents: get: tags: - Intents summary: List Intents description: >- Retrieves a paginated list of the authenticated client's intents, newest first. operationId: listIntents parameters: - name: x-api-version in: header required: true schema: type: string enum: - 2026-04.blanc description: API version. Required; pinned to this document. - name: x-api-key in: header required: true schema: type: string description: API key. - name: cursor in: query required: false schema: type: string pattern: ^\d+$ description: >- Opaque cursor from a previous response (`pagination.nextCursor`). Omit for the first page. example: '1024' description: >- Opaque cursor from a previous response (`pagination.nextCursor`). Omit for the first page. - name: limit in: query required: false schema: default: 20 type: integer minimum: 1 maximum: 100 description: Max items per page (max 100) example: 20 description: Max items per page (max 100) responses: '200': description: OK content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string description: Intent id — pass to `GET /intents/:id` example: '12345678901234567890' status: type: string enum: - PENDING - COMPLETED - FAILED description: Overall intent status example: COMPLETED fromChains: type: array items: type: number description: >- Source chain IDs — one per distinct chain the intent spends on example: - 1 - 8453 toChain: type: number description: Destination chain ID example: 10 token: type: string description: >- Intent value token. The token delivered on the destination chain, or the spent token for same-chain intents (which have no persisted delivery). example: '0x0b2c639c533813f4aa9d7837caf62653d097ff85' amount: type: string description: >- 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). example: '1000000' account: type: string description: Account that submitted the intent example: '0x3672e268a79bd4acc5ee646bdda652547c7a435c' createdAt: type: number description: Intent creation time in unix seconds example: 1633493100 required: - id - status - fromChains - account - createdAt description: A single intent list entry description: Intents on this page, newest first pagination: type: object properties: nextCursor: type: string nullable: true description: >- Pass as `cursor` to fetch the next page; null when no more results. example: '1024' hasNextPage: type: boolean example: true required: - nextCursor - hasNextPage description: Keyset pagination metadata required: - data - pagination description: Paginated list of the client’s intents '400': description: Validation error content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: {} description: >- Structured issue context (e.g. `{ path: "body.accountAddress" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: {} required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: oneOf: - type: boolean - type: string enum: - read - write description: Minimum level the endpoint demands actual: oneOf: - type: boolean - type: string enum: - none - read - write description: Level resolved on the key required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - CONFLICT - WITHDRAWAL_IN_PROGRESS - WITHDRAWAL_FINALIZATION_PENDING - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - INTERNAL_ERROR message: type: string description: Human-readable error message example: Invalid input required: - code - message '403': description: API key scope denied content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: {} description: >- Structured issue context (e.g. `{ path: "body.accountAddress" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: {} required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: oneOf: - type: boolean - type: string enum: - read - write description: Minimum level the endpoint demands actual: oneOf: - type: boolean - type: string enum: - none - read - write description: Level resolved on the key required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - CONFLICT - WITHDRAWAL_IN_PROGRESS - WITHDRAWAL_FINALIZATION_PENDING - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - INTERNAL_ERROR message: type: string description: Human-readable error message example: Invalid input required: - code - message '500': description: Server error content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: {} description: >- Structured issue context (e.g. `{ path: "body.accountAddress" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: {} required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: oneOf: - type: boolean - type: string enum: - read - write description: Minimum level the endpoint demands actual: oneOf: - type: boolean - type: string enum: - none - read - write description: Level resolved on the key required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - CONFLICT - WITHDRAWAL_IN_PROGRESS - WITHDRAWAL_FINALIZATION_PENDING - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - INTERNAL_ERROR message: type: string description: Human-readable error message example: Invalid input required: - code - message ````