> ## 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. # Get Intent > Retrieves the status of an intent along with per-claim progress across chains. ## OpenAPI ````yaml https://raw.githubusercontent.com/rhinestonewtf/openapi/refs/heads/main/orchestrator.json get /intents/{id} openapi: 3.0.2 info: title: Rhinestone Orchestrator API version: 1.0.0 servers: - url: https://v1.orchestrator.rhinestone.dev security: [] paths: /intents/{id}: get: tags: - Intents summary: Get Intent description: >- Retrieves the status of an intent along with per-claim progress across chains. parameters: - name: id in: path required: true schema: type: string pattern: ^\d+$ example: >- 77119256265773742309930654065362693497375232736834856992878277299604179621015 description: Unique identifier of the intent operation - name: x-api-key in: header required: true schema: type: string description: Rhinestone API key - name: x-api-version in: header schema: type: string pattern: ^\d{4}-\d{2}\.[a-z0-9]+$ description: >- API version (YYYY-MM.name). Will become required in a future release. example: 2026-01.alps - name: full in: query description: Whether to include intent operation details schema: type: boolean example: 'true' responses: '200': description: '200' content: application/json: schema: type: object properties: status: type: string enum: - PENDING - COMPLETED - FAILED description: 'Overall intent status: PENDING, COMPLETED, or FAILED' example: COMPLETED accountAddress: type: string description: Account address example: '0x3672e268a79bd4acc5ee646bdda652547c7a435c' operations: type: array items: type: object properties: chain: type: number description: Chain ID example: 10 items: type: array items: type: object properties: type: type: string enum: - CLAIM - FILL - BRIDGE_FILL description: 'Operation type: CLAIM, FILL, or BRIDGE_FILL' example: FILL status: type: string enum: - PENDING - COMPLETED - FAILED description: Operation status example: COMPLETED txHash: type: string description: Transaction hash (present when COMPLETED) example: >- 0xc1674f4671accbceec3f22c2c9cfa4f7aead7183f48df90c239e0d85d6c31e21 timestamp: type: number description: >- Block timestamp in unix seconds (present when COMPLETED) example: 1633493192 required: - type - status description: Operations on this chain required: - chain - items description: >- Operations grouped by chain. Each chain has one or more operations (e.g. CLAIM, FILL, BRIDGE_FILL). details: type: object properties: id: type: string description: Intent id — pass to `GET /intents/:id` example: '12345678901234567890' nonce: type: string description: Intent nonce (hex) example: >- 0x000000000000000000000000000000000000000000000000ab54a98ceb1f0ad2 recipient: type: string description: Destination recipient account example: '0x3672e268a79bd4acc5ee646bdda652547c7a435c' createdAt: type: number description: Intent creation time in unix seconds example: 1633493100 latencyMs: type: number nullable: true description: >- Time from creation to the latest leg landing, in ms. Null until any leg lands. example: 8100 settlementLayer: type: string enum: - INTENT_EXECUTOR - SAME_CHAIN - ACROSS - ECO - RELAY - OFT - NEAR - RHINO - CCTP nullable: true description: >- Settlement layer; null if the routing strategy is unrecognized example: ACROSS source: type: array items: type: object properties: chain: type: number description: Chain ID example: 10 tokens: type: array items: type: object properties: token: type: string description: Token address example: '0x0b2c639c533813f4aa9d7837caf62653d097ff85' amount: type: string description: Token amount in base units example: '1000000' required: - token - amount description: A token moved on this leg description: All tokens moved on this leg txHash: type: string description: Transaction hash (present once the leg lands) example: >- 0xc1674f4671accbceec3f22c2c9cfa4f7aead7183f48df90c239e0d85d6c31e21 timestamp: type: number description: >- Block timestamp in unix seconds (present once landed) example: 1633493192 status: type: string enum: - PENDING - COMPLETED - FAILED description: Leg status example: COMPLETED required: - chain - tokens - status description: A single source or destination leg description: Source (claim) legs destination: type: object properties: chain: type: number description: Chain ID example: 10 tokens: type: array items: type: object properties: token: type: string description: Token address example: '0x0b2c639c533813f4aa9d7837caf62653d097ff85' amount: type: string description: Token amount in base units example: '1000000' required: - token - amount description: A token moved on this leg description: All tokens moved on this leg txHash: type: string description: Transaction hash (present once the leg lands) example: >- 0xc1674f4671accbceec3f22c2c9cfa4f7aead7183f48df90c239e0d85d6c31e21 timestamp: type: number description: >- Block timestamp in unix seconds (present once landed) example: 1633493192 status: type: string enum: - PENDING - COMPLETED - FAILED description: Leg status example: COMPLETED required: - chain - tokens - status description: >- Destination (fill) leg; null before a fill is dispatched nullable: true cost: type: object properties: sponsored: type: boolean description: Whether gas/fees were sponsored for this intent example: true sponsoredValue: type: string description: Sponsored value in fee-token base units example: '210000' protocolFee: type: string description: Protocol fee in fee-token base units example: '10000' required: - sponsored description: >- Cost summary from the recorded fee sponsorship. Amounts are raw base units; omitted when no sponsorship row exists. required: - id - nonce - recipient - createdAt - latencyMs - settlementLayer - source - destination - cost description: Extended intent details, returned only when `full=true` required: - status - accountAddress - operations description: Successfully retrieved intent operation status '400': description: '400' 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: nullable: true 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: nullable: true 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 - 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 description: Invalid intent ID '403': description: '403' 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: nullable: true 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: nullable: true 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 - 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 description: API key scope denied '404': description: '404' 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: nullable: true 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: nullable: true 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 - 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 description: Intent ID not found '500': description: '500' 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: nullable: true 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: nullable: true 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 - 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 description: Server error ````