> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Intent Status

> Query the current status of a cross-chain intent transaction. Provide one of: intentHash, intentCreatedHash, or fulfillmentHash to track the intent's progress through the execution lifecycle.



## OpenAPI

````yaml /openapi.json post /api/v3/intents/intentStatus
openapi: 3.0.0
info:
  title: Eco Routes API
  description: Eco Routes API documentation
  version: '1.0'
  contact: {}
servers:
  - url: https://quotes.eco.com
    description: Production
  - url: https://quotes-preprod.eco.com
    description: Preproduction
  - url: https://quotes.staging.eco.com
    description: Staging
  - url: http://localhost:3000
    description: Local
security: []
tags: []
paths:
  /api/v3/intents/intentStatus:
    post:
      tags:
        - Quotes V3
      summary: Get Intent Status
      description: >-
        Query the current status of a cross-chain intent transaction. Provide
        one of: intentHash, intentCreatedHash, or fulfillmentHash to track the
        intent's progress through the execution lifecycle.
      operationId: IntentsController_getIntentStatus
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IntentStatusRequestV3DTO'
      responses:
        '200':
          description: Successfully retrieved intent status and transaction details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntentStatusResponseV3DTO'
components:
  schemas:
    IntentStatusRequestV3DTO:
      type: object
      properties:
        intentHash:
          type: string
          description: Hash of the intent to query status for
        intentCreatedHash:
          type: string
          description: Transaction hash of the intent creation transaction
        fulfillmentHash:
          type: string
          description: Transaction hash of the intent fulfillment transaction
      oneOf:
        - required:
            - intentHash
        - required:
            - intentCreatedHash
        - required:
            - fulfillmentHash
    IntentStatusResponseV3DTO:
      type: object
      properties:
        data:
          description: Intent status response data
          allOf:
            - $ref: '#/components/schemas/IntentStatusV3DTO'
      required:
        - data
    IntentStatusV3DTO:
      type: object
      properties:
        intentHash:
          type: string
          description: Hash of the intent being tracked
          example: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12'
        status:
          description: Current status and sub-status of the intent execution
          allOf:
            - $ref: '#/components/schemas/StatusV3DTO'
        intentCreated:
          description: Transaction details for when the intent was created
          allOf:
            - $ref: '#/components/schemas/TransactionInfoV3DTO'
        fulfillment:
          description: Transaction details for when the intent was fulfilled (if completed)
          allOf:
            - $ref: '#/components/schemas/TransactionInfoV3DTO'
        refund:
          description: Transaction details for when the intent was refunded (if refunded)
          allOf:
            - $ref: '#/components/schemas/TransactionInfoV3DTO'
      required:
        - intentHash
        - status
        - intentCreated
    StatusV3DTO:
      type: object
      properties:
        status:
          type: string
          enum:
            - Pending
            - Completed
          description: High-level status of the intent (Pending or Completed)
          example: Pending
        subStatus:
          type: string
          enum:
            - WaitingToFulfill
            - WaitingForRefund
            - Fulfilled
            - Refunded
          description: Detailed status indicating the specific stage of intent execution
          example: WaitingToFulfill
        subStatusMessage:
          type: string
          description: Human-readable description of the substatus
          example: The intent is waiting to be fulfilled
      required:
        - status
        - subStatus
        - subStatusMessage
    TransactionInfoV3DTO:
      type: object
      properties:
        chainId:
          type: number
          description: Chain ID where this transaction occurred
          example: 1
        transactionHash:
          type: string
          description: Hash of the transaction
          example: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12'
        blockExplorerUrl:
          type: string
          description: URL to view this transaction on a block explorer
          example: >-
            https://etherscan.io/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12
      required:
        - chainId
        - transactionHash
        - blockExplorerUrl

````