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

# Check Relay bridge transaction status

`GET /api/v1/relay/bridge/check`

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

## Query parameters

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

## Response `200`

Bridge transaction status and details

- RelayBridgeTransactionResponse
  - `sourceChainId` number, required — Source chain ID where the Relay message was sent from
  - `sourceTxHash` string, required — Source chain transaction hash
  - `destinationChainId` number — Destination chain ID where the Relay message was delivered
  - `destinationTxHash` string — Destination chain transaction hash (if message was delivered)
  - `refundChainId` number — Chain the funds were refunded on — the origin chain — present when the request was refunded instead of delivered. destinationChainId then names the intended destination and destinationTxHash is absent (nothing arrived there).
  - `refundTxHash` string — The refund payout transaction, present when the request was refunded instead of delivered
  - `status` 'pending' | 'inflight' | 'delivered' | 'failed' | 'unknown', required — Overall bridge status
  - `relayRequest` RelayRequestData
    - `status` 'success' | 'failure' | 'refund' | 'pending' | 'depositing' | 'waiting', required — Relay request status
    - `user` string — User address that initiated the bridge
    - `recipient` string — Recipient address on destination chain
    - `inTxs` RelayTx[] — Source chain transactions
      - `hash` string, required — Transaction hash
      - `chainId` number, required — Chain ID
      - `block` number — Block number
      - `timestamp` number — Transaction timestamp (unix seconds)
      - `status` string — Transaction status
    - `outTxs` RelayTx[] — Destination chain transactions
      - `hash` string, required — Transaction hash
      - `chainId` number, required — Chain ID
      - `block` number — Block number
      - `timestamp` number — Transaction timestamp (unix seconds)
      - `status` string — Transaction status
    - `currency` RelayCurrencyInfo
      - `chainId` number, required — Chain ID of the currency
      - `address` string, required — Token contract address
      - `symbol` string, required — Token symbol
      - `name` string, required — Token name
      - `decimals` number, required — Token decimals
    - `fees` RelayFees
      - `gas` string, required — Estimated gas cost in wei
      - `fixed` string, required — Fixed fee in wei
      - `price` string, required — Dynamic fee from chain and amount in wei
      - `gateway` string — Fee taken by API gateway in wei
    - `feesUsd` RelayFees
      - `gas` string, required — Estimated gas cost in wei
      - `fixed` string, required — Fixed fee in wei
      - `price` string, required — Dynamic fee from chain and amount in wei
      - `gateway` string — Fee taken by API gateway in wei
    - `failReason` string — Reason for failure if the bridge failed
    - `createdAt` string — When the relay request was created
    - `updatedAt` string — When the relay request was last updated
  - `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
  - `error` string — Error message if the API request failed (e.g., transaction not found, API errors)

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