> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enso.build/llms.txt
> Use this file to discover all available pages before exploring further.

# Check Mayan bridge order status

> Returns the delivery or refund status of a Mayan Swift order, looked up from the source transaction.



## OpenAPI

````yaml /public/openapi.json get /api/v1/mayan/bridge/check
openapi: 3.0.0
info:
  title: Enso API
  description: >-
    #### Enso API

    - Find detailed documentation on
    [docs.enso.finance](https://docs.enso.finance).

    - To use the API, **you must include your API Key in the Authorization
    header** (Bearer format).

    - For testing, Swagger pre-authorizes you using the key:
    `1e02632d-6feb-4a75-a157-documentation` (1rps).

    - Get your own API Key at
    [enso.finance/developers](https://enso.finance/developers).
  version: 1.0.1
  contact: {}
servers:
  - url: https://api.enso.build
security:
  - {}
tags:
  - name: shortcuts
    description: ''
paths:
  /api/v1/mayan/bridge/check:
    get:
      tags:
        - Integration
        - Crosschain
      summary: Check Mayan bridge order status
      description: >-
        Returns the delivery or refund status of a Mayan Swift order, looked up
        from the source transaction.
      operationId: MayanController_checkBridgeTransaction
      parameters:
        - name: chainId
          required: true
          in: query
          description: Chain ID of the source transaction
          schema:
            example: 8453
            type: number
        - name: txHash
          required: true
          in: query
          description: Source transaction hash that created the Swift order
          schema:
            example: '0x0bf1b6817c4c085c40cafe329fa451a0d0875258f3715b0ee8e4b5a7f005fbe7'
            type: string
      responses:
        '200':
          description: Bridge transaction status and details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MayanBridgeTransactionResponse'
        '429':
          description: Rate limit exceeded
components:
  schemas:
    MayanBridgeTransactionResponse:
      type: object
      properties:
        sourceChainId:
          type: number
          description: Chain ID of the source transaction
          example: 8453
        sourceTxHash:
          type: string
          description: Source transaction hash
          example: '0x0bf1b6817c4c085c40cafe329fa451a0d0875258f3715b0ee8e4b5a7f005fbe7'
        orderHash:
          type: string
          description: Swift order hash
        destinationChainId:
          type: number
          description: Destination chain ID of the order
          example: 56
        destinationTxHash:
          type: string
          description: >-
            Destination transaction that fulfilled the order (present when
            delivered). A Solana signature for Solana destinations.
          example: '0x9038c72fdb050784c7de4aba1f4c7fed85878cd1ee1d4f856ba46680874e4379'
        refundChainId:
          type: number
          description: >-
            Chain the order was refunded on, which is the source chain. Present
            when the order was refunded instead of fulfilled. destinationChainId
            then names the intended destination.
          example: 8453
        refundTxHash:
          type: string
          description: >-
            Refund transaction, present when the order was refunded instead of
            fulfilled
        status:
          type: string
          description: Overall bridge status
          enum:
            - pending
            - inflight
            - delivered
            - failed
            - unknown
        mayanStatus:
          type: string
          description: Order status reported by the Mayan explorer
          example: ORDER_SETTLED
        intent:
          description: >-
            Present when the source transaction published a cross-chain intent:
            Mayan only delivers funds to the intent's ephemeral executor, and a
            keeper then executes the intent (or refunds it past its deadline) in
            a separate destination transaction. `status: delivered` means the
            Swift order delivered the funds to the executor, the execution
            itself is reported here.
          allOf:
            - $ref: '#/components/schemas/BridgeRouteIntent'
        destinationExecutionTxHash:
          type: string
          description: >-
            The keeper's intent execution transaction on the destination chain,
            once executed. destinationTxHash is only the Swift fulfillment that
            funded the executor.
        ensoDestinationEvent:
          description: >-
            Enso shortcut event from the keeper's intent execution transaction.
            Null if not found.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/EnsoEvent'
        error:
          type: string
          description: Error message when the status could not be determined
          example: No Mayan Swift order found in transaction 0x...
      required:
        - sourceChainId
        - sourceTxHash
        - status
    BridgeRouteIntent:
      type: object
      properties:
        requestId:
          type: string
          description: Intent request id (bytes32) published by the source transaction
        executor:
          type: string
          description: >-
            Ephemeral executor address the bridge delivers to on the execution
            chain (lowercase)
        executionChainId:
          type: number
          description: Chain the intent executes (and refunds) on
        phase:
          type: string
          description: Coarse lifecycle phase of the destination stage
          enum:
            - awaiting_funds
            - executing
            - executed
            - refunding
            - refunded
            - failed
            - unknown
        status:
          type: string
          description: >-
            The keeper's own lifecycle status (pending | waiting_funds |
            inflight | executed | failed | failed_permanent | expired |
            refund_pending | refund_inflight | refunded | refund_skipped |
            refund_failed), or unknown
        statusDescription:
          type: string
          description: Human-readable status explanation
        source:
          type: string
          description: >-
            Where the stage was read from: the intent keeper, or only the chain
            itself
          enum:
            - keeper
            - onchain
        deadline:
          type: string
          description: Intent deadline (ISO 8601). Past it the executor can only refund.
        executionTxHash:
          type: string
          description: The keeper's execution transaction
        executionExplorerUrl:
          type: string
          description: Block-explorer link for the execution transaction
        executedAt:
          type: string
          description: When the execution mined (ISO 8601)
        refundTxHash:
          type: string
          description: The repayment transaction, when funds were swept back
        refundExplorerUrl:
          type: string
          description: Block-explorer link for the repayment transaction
        refundedAt:
          type: string
          description: When the repayment mined (ISO 8601)
        error:
          type: string
          description: Last error the keeper recorded for this intent, if any
      required:
        - requestId
        - executor
        - phase
        - status
        - source
    EnsoEvent:
      type: object
      properties:
        accountId:
          type: string
          description: Account ID from ShortcutExecuted event
        requestId:
          type: string
          description: Request ID from ShortcutExecuted event
        blockNumber:
          type: number
          description: Block number where the event was emitted
        transactionHash:
          type: string
          description: Transaction hash
        chainId:
          type: number
          description: Chain ID where the event was emitted
        success:
          type: boolean
          description: Whether the shortcut execution was successful
        error:
          type: string
          description: Error data if execution failed
        refundDetails:
          description: Refund details if execution failed and funds were returned
          allOf:
            - $ref: '#/components/schemas/RefundDetails'
      required:
        - blockNumber
        - transactionHash
        - chainId
        - success
    RefundDetails:
      type: object
      properties:
        token:
          type: string
          description: Token address (0xeee... for native token)
        amount:
          type: string
          description: Amount refunded
        recipient:
          type: string
          description: Recipient address
        isNative:
          type: boolean
          description: Whether the refund is in native token
      required:
        - token
        - amount
        - recipient
        - isNative

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.