---
title: "Get Intent Status Array"
method: POST
path: "/api/v3/intents/status"
tags: ["Quotes V3"]
---

# Get Intent Status Array

`POST /api/v3/intents/status`

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.

## Request body

- union
  - object
    - `intentHash` string, required — Hash of the intent to query status for
    - `intentCreatedHash` string — Transaction hash of the intent creation transaction
    - `fulfillmentHash` string — Transaction hash of the intent fulfillment transaction
  - object
    - `intentHash` string — Hash of the intent to query status for
    - `intentCreatedHash` string, required — Transaction hash of the intent creation transaction
    - `fulfillmentHash` string — Transaction hash of the intent fulfillment transaction
  - object
    - `intentHash` string — Hash of the intent to query status for
    - `intentCreatedHash` string — Transaction hash of the intent creation transaction
    - `fulfillmentHash` string, required — Transaction hash of the intent fulfillment transaction

## Response `200`

Successfully retrieved array of intent statuses ordered by log index

- IntentStatusArrayResponseV3DTO
  - `data` IntentStatusWithMetadataV3DTO[], required — Array of intent statuses matching the search criteria (with log indexes and timestamps)
    - `intentHash` string, required — Hash of the intent being tracked
    - `status` StatusV3DTO, required
      - `status` 'Pending' | 'Completed', required — High-level status of the intent (Pending or Completed)
      - `subStatus` 'WaitingToFulfill' | 'WaitingForRefund' | 'Fulfilled' | 'Refunded', required — Detailed status indicating the specific stage of intent execution
      - `subStatusMessage` string, required — Human-readable description of the substatus
    - `intentData` IntentDataV3DTO, required
      - `sourceChainID` number, required — Source chain ID where the intent was created
      - `destinationChainID` number, required — Destination chain ID where the intent will be fulfilled
      - `creator` string, required — Address that created the intent
      - `refundRecipient` string — Address that received the refund (only set when intent has been refunded)
      - `deadline` number, required — Unix timestamp when the intent expires and becomes refundable
      - `createdAt` number, required — Unix timestamp when the intent was created
      - `sourceTransfers` SourceTransferV3DTO[], required — Array of reward token transfers (what the prover receives from the creator). Does not include recipients.
        - `token` string, required — Token address (use "0x" for native tokens)
        - `amount` string, required — Token amount as string
      - `destinationTransfers` DestinationTransferV3DTO[], required — Array of destination transfers (tokens and recipients on the destination chain). Always includes recipients.
        - `token` string, required — Token address (use "0x" for native tokens)
        - `amount` string, required — Token amount as string
        - `recipient` string, required — Recipient address for this transfer
    - `sendingTxs` TransactionWithTransfersV3DTO[], required — Transactions that sent tokens on the source chain (intent creation). Transfers do not include recipients.
      - `chainId` number, required — Chain ID where this transaction occurred
      - `timestamp` number, required — Unix timestamp of the transaction
      - `txHash` string, required — Transaction hash
      - `txLink` string, required — Block explorer URL for this transaction
      - `transfers` union[], required — Token transfers associated with this transaction. Source transfers (sendingTxs) do not include recipients. Destination transfers (receivingTxs) include recipients.
        - union
          - SourceTransferV3DTO
            - `token` string, required — Token address (use "0x" for native tokens)
            - `amount` string, required — Token amount as string
          - DestinationTransferV3DTO
            - `token` string, required — Token address (use "0x" for native tokens)
            - `amount` string, required — Token amount as string
            - `recipient` string, required — Recipient address for this transfer
    - `receivingTxs` TransactionWithTransfersV3DTO[], required — Transactions that received tokens on the destination chain (fulfillment or refund). Transfers always include recipients.
      - `chainId` number, required — Chain ID where this transaction occurred
      - `timestamp` number, required — Unix timestamp of the transaction
      - `txHash` string, required — Transaction hash
      - `txLink` string, required — Block explorer URL for this transaction
      - `transfers` union[], required — Token transfers associated with this transaction. Source transfers (sendingTxs) do not include recipients. Destination transfers (receivingTxs) include recipients.
        - union
          - SourceTransferV3DTO
            - `token` string, required — Token address (use "0x" for native tokens)
            - `amount` string, required — Token amount as string
          - DestinationTransferV3DTO
            - `token` string, required — Token address (use "0x" for native tokens)
            - `amount` string, required — Token amount as string
            - `recipient` string, required — Recipient address for this transfer

## Other responses

- `404` — No intents found matching the search criteria

---

[API](https://skmtc.net/eco/apis/eco-routes-api.md) · [All operations](https://skmtc.net/eco/apis/eco-routes-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eco/eco-routes-api/revisions/93b1df7599da/schema)