> ## 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 Array

> Query the status of multiple intents created in the same transaction. Returns an array of intent statuses ordered by creation event log index. Provide one of: intentHash, intentCreatedHash, or fulfillmentHash. Limited to 100 results.



## OpenAPI

````yaml /openapi.json post /api/v3/intents/status
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/status:
    post:
      tags:
        - Quotes V3
      summary: Get Intent Status Array
      description: >-
        Query the status of multiple intents created in the same transaction.
        Returns an array of intent statuses ordered by creation event log index.
        Provide one of: intentHash, intentCreatedHash, or fulfillmentHash.
        Limited to 100 results.
      operationId: IntentsController_getIntentStatusArray
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IntentStatusRequestV3DTO'
      responses:
        '200':
          description: Successfully retrieved array of intent statuses ordered by log index
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntentStatusArrayResponseV3DTO'
        '404':
          description: No intents found matching the search criteria
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
    IntentStatusArrayResponseV3DTO:
      type: object
      properties:
        data:
          description: >-
            Array of intent statuses matching the search criteria (with log
            indexes and timestamps)
          type: array
          items:
            $ref: '#/components/schemas/IntentStatusWithMetadataV3DTO'
      required:
        - data
    IntentStatusWithMetadataV3DTO:
      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'
        intentData:
          description: >-
            Intent definition data including chain IDs, creator, deadline, and
            transfers
          allOf:
            - $ref: '#/components/schemas/IntentDataV3DTO'
        sendingTxs:
          description: >-
            Transactions that sent tokens on the source chain (intent creation).
            Transfers do not include recipients.
          example:
            - chainId: 42161
              timestamp: 1729163645
              txHash: >-
                0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f
              txLink: >-
                https://arbiscan.io/tx/0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f
              transfers:
                - token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
                  amount: '1000000'
          type: array
          items:
            $ref: '#/components/schemas/TransactionWithTransfersV3DTO'
        receivingTxs:
          description: >-
            Transactions that received tokens on the destination chain
            (fulfillment or refund). Transfers always include recipients.
          example:
            - chainId: 10
              timestamp: 1729164000
              txHash: >-
                0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890
              txLink: >-
                https://optimistic.etherscan.io/tx/0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890
              transfers:
                - token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
                  amount: '1000000'
                  recipient: '0x054968e2f376192c69b8f30870d450519ff77ac8'
          type: array
          items:
            $ref: '#/components/schemas/TransactionWithTransfersV3DTO'
      required:
        - intentHash
        - status
        - intentData
        - sendingTxs
        - receivingTxs
    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
    IntentDataV3DTO:
      type: object
      properties:
        sourceChainID:
          type: number
          description: Source chain ID where the intent was created
          example: 42161
        destinationChainID:
          type: number
          description: Destination chain ID where the intent will be fulfilled
          example: 167000
        creator:
          type: string
          description: Address that created the intent
          example: '0x1234567890abcdef1234567890abcdef12345678'
        refundRecipient:
          type: string
          description: >-
            Address that received the refund (only set when intent has been
            refunded)
          example: '0x1234567890abcdef1234567890abcdef12345678'
        deadline:
          type: number
          description: Unix timestamp when the intent expires and becomes refundable
          example: 1730000000
        createdAt:
          type: number
          description: Unix timestamp when the intent was created
          example: 1729500000
        sourceTransfers:
          description: >-
            Array of reward token transfers (what the prover receives from the
            creator). Does not include recipients.
          example:
            - token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
              amount: '1000000'
          type: array
          items:
            $ref: '#/components/schemas/SourceTransferV3DTO'
        destinationTransfers:
          description: >-
            Array of destination transfers (tokens and recipients on the
            destination chain). Always includes recipients.
          example:
            - token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
              amount: '1000000'
              recipient: '0x054968e2f376192c69b8f30870d450519ff77ac8'
          type: array
          items:
            $ref: '#/components/schemas/DestinationTransferV3DTO'
      required:
        - sourceChainID
        - destinationChainID
        - creator
        - deadline
        - createdAt
        - sourceTransfers
        - destinationTransfers
    TransactionWithTransfersV3DTO:
      type: object
      properties:
        chainId:
          type: number
          description: Chain ID where this transaction occurred
          example: 42161
        timestamp:
          type: number
          description: Unix timestamp of the transaction
          example: 1729163645
        txHash:
          type: string
          description: Transaction hash
          example: '0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f'
        txLink:
          type: string
          description: Block explorer URL for this transaction
          example: >-
            https://arbiscan.io/tx/0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f
        transfers:
          type: array
          description: >-
            Token transfers associated with this transaction. Source transfers
            (sendingTxs) do not include recipients. Destination transfers
            (receivingTxs) include recipients.
          items:
            oneOf:
              - $ref: '#/components/schemas/SourceTransferV3DTO'
              - $ref: '#/components/schemas/DestinationTransferV3DTO'
          example:
            - token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
              amount: '1000000'
              recipient: '0x054968e2f376192c69b8f30870d450519ff77ac8'
      required:
        - chainId
        - timestamp
        - txHash
        - txLink
        - transfers
    SourceTransferV3DTO:
      type: object
      properties:
        token:
          type: string
          description: Token address (use "0x" for native tokens)
          example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        amount:
          type: string
          description: Token amount as string
          example: '1000000'
      required:
        - token
        - amount
    DestinationTransferV3DTO:
      type: object
      properties:
        token:
          type: string
          description: Token address (use "0x" for native tokens)
          example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        amount:
          type: string
          description: Token amount as string
          example: '1000000'
        recipient:
          type: string
          description: Recipient address for this transfer
          example: '0x9876543210abcdef9876543210abcdef98765432'
      required:
        - token
        - amount
        - recipient

````