---
title: "Check bridge transaction status"
method: GET
path: "/api/v1/layerzero/bridge/check"
tags: ["layerzero"]
---

# Check bridge transaction status

`GET /api/v1/layerzero/bridge/check`

Returns comprehensive information about a cross-chain bridge transaction, including LayerZero message status, on-chain events, and transaction data from Enso.

## Query parameters

- `chainId` number, required
- `txHash` string, required

## Response `200`

Bridge transaction status and details

- BridgeTransactionResponse
  - `sourceChainId` number, required — Source chain ID
  - `sourceTxHash` string, required — Source transaction hash
  - `destinationChainId` number — Destination chain ID (if known)
  - `destinationTxHash` string — Destination transaction hash (if completed)
  - `status` 'pending' | 'inflight' | 'delivered' | 'failed' | 'ready_for_manual_execution' | 'unknown', required — Overall bridge status
  - `isMultiBridge` boolean — Whether this transaction involves multiple sequential bridges. Only present when true.
  - `hops` BridgeHop[] — Array of individual bridge hops. Only present for multi-bridge transactions.
    - `sourceChainId` number, required — Source chain ID for this hop
    - `sourceTxHash` string, required — Source transaction hash for this hop
    - `destinationChainId` number — Destination chain ID (if known)
    - `destinationTxHash` string — Destination transaction hash (if completed)
    - `status` 'pending' | 'inflight' | 'delivered' | 'failed' | 'ready_for_manual_execution' | 'unknown', required — Status of this hop
    - `layerZeroMessage` LayerZeroMessageStatus
      - `srcEid` number, required — Source chain endpoint ID
      - `dstEid` number, required — Destination chain endpoint ID
      - `srcChainId` number — Source chain ID (EVM)
      - `dstChainId` number — Destination chain ID (EVM)
      - `status` string, required — Message status from LayerZero
      - `srcTxHash` string — Source transaction hash
      - `dstTxHash` string — Destination transaction hash (if delivered)
      - `srcBlockNumber` number — Source block number
      - `dstBlockNumber` number — Destination block number (if delivered)
      - `srcTimestamp` string — Source timestamp
      - `dstTimestamp` string — Destination timestamp (if delivered)
      - `sender` string — Sender address
      - `receiver` string — Receiver address
    - `ensoSourceEvent` EnsoEvent
      - `accountId` string — Account ID from ShortcutExecuted event
      - `requestId` string — Request ID from ShortcutExecuted event
      - `blockNumber` number, required — Block number where the event was emitted
      - `transactionHash` string, required — Transaction hash
      - `chainId` number, required — Chain ID where the event was emitted
      - `success` boolean, required — Whether the shortcut execution was successful
      - `error` string — Error data if execution failed
      - `refundDetails` RefundDetails
        - `token` string, required — Token address (0xeee... for native token)
        - `amount` string, required — Amount refunded
        - `recipient` string, required — Recipient address
        - `isNative` boolean, required — Whether the refund is in native token
    - `ensoDestinationEvent` EnsoEvent
      - `accountId` string — Account ID from ShortcutExecuted event
      - `requestId` string — Request ID from ShortcutExecuted event
      - `blockNumber` number, required — Block number where the event was emitted
      - `transactionHash` string, required — Transaction hash
      - `chainId` number, required — Chain ID where the event was emitted
      - `success` boolean, required — Whether the shortcut execution was successful
      - `error` string — Error data if execution failed
      - `refundDetails` RefundDetails
        - `token` string, required — Token address (0xeee... for native token)
        - `amount` string, required — Amount refunded
        - `recipient` string, required — Recipient address
        - `isNative` boolean, required — Whether the refund is in native token
  - `layerZeroMessage` LayerZeroMessageStatus
    - `srcEid` number, required — Source chain endpoint ID
    - `dstEid` number, required — Destination chain endpoint ID
    - `srcChainId` number — Source chain ID (EVM)
    - `dstChainId` number — Destination chain ID (EVM)
    - `status` string, required — Message status from LayerZero
    - `srcTxHash` string — Source transaction hash
    - `dstTxHash` string — Destination transaction hash (if delivered)
    - `srcBlockNumber` number — Source block number
    - `dstBlockNumber` number — Destination block number (if delivered)
    - `srcTimestamp` string — Source timestamp
    - `dstTimestamp` string — Destination timestamp (if delivered)
    - `sender` string — Sender address
    - `receiver` string — Receiver address
  - `ensoSourceEvent` EnsoEvent
    - `accountId` string — Account ID from ShortcutExecuted event
    - `requestId` string — Request ID from ShortcutExecuted event
    - `blockNumber` number, required — Block number where the event was emitted
    - `transactionHash` string, required — Transaction hash
    - `chainId` number, required — Chain ID where the event was emitted
    - `success` boolean, required — Whether the shortcut execution was successful
    - `error` string — Error data if execution failed
    - `refundDetails` RefundDetails
      - `token` string, required — Token address (0xeee... for native token)
      - `amount` string, required — Amount refunded
      - `recipient` string, required — Recipient address
      - `isNative` boolean, required — Whether the refund is in native token
  - `ensoDestinationEvent` EnsoEvent
    - `accountId` string — Account ID from ShortcutExecuted event
    - `requestId` string — Request ID from ShortcutExecuted event
    - `blockNumber` number, required — Block number where the event was emitted
    - `transactionHash` string, required — Transaction hash
    - `chainId` number, required — Chain ID where the event was emitted
    - `success` boolean, required — Whether the shortcut execution was successful
    - `error` string — Error data if execution failed
    - `refundDetails` RefundDetails
      - `token` string, required — Token address (0xeee... for native token)
      - `amount` string, required — Amount refunded
      - `recipient` string, required — Recipient address
      - `isNative` boolean, required — Whether the refund is in native token
  - `ensoMetadata` EnsoMetadata
    - `tokenIn` string — Token in address
    - `tokenOut` string — Token out address
    - `amountIn` string — Amount in
    - `chainId` number — Chain ID from the request
    - `timestamp` number — Timestamp of the request
  - `error` string — Error message if something went wrong

## Other responses

- `429` — Rate limit exceeded

---

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