---
title: "getStatus"
method: GET
path: "/cross-chain/status"
tags: ["Cross-Chain"]
---

# getStatus

`GET /cross-chain/status`

Get the status of a cross chain transaction

## Query parameters

- `originChain` string, required
- `originTxHash` string, required
- `quoteId` string

## Headers

- `0x-api-key` string, required

## Response `200`

Successful response

- object
  - `status` 'origin_tx_pending' | 'origin_tx_succeeded' | 'origin_tx_confirmed' | 'origin_tx_reverted' | 'bridge_pending' | 'bridge_filled' | 'bridge_failed' | 'unknown', required — The current status of the cross-chain transaction
  - `bridge` string — The bridge provider handling the cross-chain transfer
  - `steps` union[], required — The steps involved in the cross-chain transaction
    - union
      - object
        - `chainId` number, required — The chain ID where this step will be executed
        - `sellToken` string, required — The input token address for this step
        - `buyToken` string, required — The output token address for this step
        - `transactions` object[], required — The transactions involved in this step
          - `chainId` number, required — The chain ID where this transaction occurred
          - `chain` string, required — The name of the chain where this transaction occurred
          - `txHash` string, nullable, required — The transaction hash on this specific chain
          - `timestamp` integer, required — Unix timestamp when this transaction was confirmed on-chain
        - `type` 'wrap', required
      - object
        - `chainId` number, required — The chain ID where this step will be executed
        - `sellToken` string, required — The input token address for this step
        - `buyToken` string, required — The output token address for this step
        - `transactions` object[], required — The transactions involved in this step
          - `chainId` number, required — The chain ID where this transaction occurred
          - `chain` string, required — The name of the chain where this transaction occurred
          - `txHash` string, nullable, required — The transaction hash on this specific chain
          - `timestamp` integer, required — Unix timestamp when this transaction was confirmed on-chain
        - `type` 'unwrap', required
      - object
        - `chainId` number, required — The chain ID where this swap will be executed
        - `sellToken` string, required — The input token address for this swap
        - `buyToken` string, required — The output token address for this swap
        - `estimatedTimeSeconds` integer, nullable, required — Estimated time for this swap step to complete
        - `transactions` object[], required — The transactions involved in this step
          - `chainId` number, required — The chain ID where this transaction occurred
          - `chain` string, required — The name of the chain where this transaction occurred
          - `txHash` string, nullable, required — The transaction hash on this specific chain
          - `timestamp` integer, required — Unix timestamp when this transaction was confirmed on-chain
        - `type` 'swap', required
      - object
        - `bridge` string, required — The bridge provider
        - `originChainId` number, required — The origin chain ID
        - `destinationChainId` number, required — The destination chain ID
        - `sellToken` union, required — The input token address for this bridge
          - string
          - string
          - string
          - string
        - `buyToken` union, required — The output token address for this bridge
          - string
          - string
          - string
          - string
        - `estimatedTimeSeconds` integer, nullable, required — Estimated time for this bridge step to complete
        - `transactions` object[], required — The transactions involved in this step
          - `chainId` number, required — The chain ID where this transaction occurred
          - `chain` string, required — The name of the chain where this transaction occurred
          - `txHash` string, nullable, required — The transaction hash on this specific chain
          - `timestamp` integer, required — Unix timestamp when this transaction was confirmed on-chain
        - `type` 'bridge', required
  - `failure` object, nullable, required — The failure context for the cross-chain transaction
    - `reason` string, required — The reason for the failure
    - `status` 'refund_pending' | 'refund_succeeded' | 'manual_action_required' | 'no_actions_required' | 'failed', required — The status of the failure
    - `transactions` object[], required — The transactions involved in the failure
      - `chainId` number, required — The chain ID where this transaction occurred
      - `chain` string, required — The name of the chain where this transaction occurred
      - `txHash` string, nullable, required — The transaction hash on this specific chain
      - `timestamp` integer, required — Unix timestamp when this transaction was confirmed on-chain
    - `recovery` object, nullable, required — The recovery step for the failure
      - `chainId` number, required — The chain ID where this recovery step will be executed
      - `token` union, required — The token address of the funds to be recovered
        - string
        - string
        - string
        - string
      - `estimatedTimeSeconds` integer, nullable, required — Estimated time for this recovery step to finish, measured from when the recovery process begins
      - `deadline` integer, nullable, required — The deadline timestamp of which the funds are available for recovery, if applicable. Not initiating the recovery process within this deadline may result in funds being forever lost
      - `manualTransaction` union, required — The manual transaction for submission, if applicable. This transaction may be submitted by anyone to initiate the recovery process
        - object
          - `chainType` 'evm', required — The blockchain type for Ethereum-compatible chains
          - `details` object, required
            - `to` string, required — The contract address to send the transaction to on the EVM chain
            - `data` string, required — The calldata containing execution details for the EVM transaction
        - object
          - `chainType` 'svm', required — The blockchain type for Solana Virtual Machine
          - `details` object, required
            - `serializedTransaction` string, required — The base64-encoded serialized Solana transaction
        - object
          - `chainType` 'tvm', required — The blockchain type for Tron Virtual Machine
          - `details` object, required
            - `to` string, required — The Tron contract address to interact with
            - `data` string, required — The calldata for the Tron smart contract call
            - `ownerAddress` string, required — The Tron address of the transaction sender
            - `memo` string — Optional memo attached to the Tron transaction
  - `transactions` object[], required — List of all blockchain transactions involved in this cross-chain swap, across multiple chains
    - `chainId` number, required — The chain ID where this transaction occurred
    - `chain` string, required — The name of the chain where this transaction occurred
    - `txHash` string, nullable, required — The transaction hash on this specific chain
    - `timestamp` integer, required — Unix timestamp when this transaction was confirmed on-chain
  - `zid` string, required — The unique ZeroEx identifier of the request

## Other responses

- `400` — 400 error response
- `404` — 404 error response
- `500` — 500 error response

---

[API](https://skmtc.net/0xproject/apis/0x-cross-chain-api.md) · [All operations](https://skmtc.net/0xproject/apis/0x-cross-chain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/0xproject/0x-cross-chain-api/versions/043dbd431099/schema)