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

# Get Intent Status

`POST /api/v3/intents/intentStatus`

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.

## 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 intent status and transaction details

- IntentStatusResponseV3DTO
  - `data` IntentStatusV3DTO, required
    - `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
    - `intentCreated` TransactionInfoV3DTO, required
      - `chainId` number, required — Chain ID where this transaction occurred
      - `transactionHash` string, required — Hash of the transaction
      - `blockExplorerUrl` string, required — URL to view this transaction on a block explorer
    - `fulfillment` TransactionInfoV3DTO
      - `chainId` number, required — Chain ID where this transaction occurred
      - `transactionHash` string, required — Hash of the transaction
      - `blockExplorerUrl` string, required — URL to view this transaction on a block explorer
    - `refund` TransactionInfoV3DTO
      - `chainId` number, required — Chain ID where this transaction occurred
      - `transactionHash` string, required — Hash of the transaction
      - `blockExplorerUrl` string, required — URL to view this transaction on a block explorer

---

[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)