---
title: "GET /v2/order-bundles/bridge-status"
method: GET
path: "/v2/order-bundles/bridge-status"
---

# GET /v2/order-bundles/bridge-status

`GET /v2/order-bundles/bridge-status`

## Request

- Base URL: `https://api.arbital.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.arbital.xyz/v2/order-bundles/bridge-status`
- Auth: HTTP bearer

Read owned Relay request status with source and destination receipt verification, for a funding or return bridge. Provider IDs are checked against authenticated participants; no balance increase heuristic or arbitrary URL is accepted.

## Query parameters

- `request_id` string, required
- `direction` 'funding' | 'return', required
- `source_transaction_id` string, required

## Response `200`

Owned bridge observation

- union
  - object
    - `state` 'ready', required
    - `bridge` OrderBundleBridgeEvidenceV2, required: Owned provider request cross-checked with chain receipts. Confirmed Solana or canonical mined Base observations can reorganize; this is not an irreversible settlement or exclusive allocation proof.
      - `request_id` string, required
      - `source_transaction_id` string, required
      - `destination_transaction_ids` string[], required
      - `sent_atomic` string, required
      - `received_atomic` string, required
      - `source_commitment` 'confirmed' | 'canonical_mined', required
      - `destination_commitment` 'confirmed' | 'canonical_mined', required
      - `source_block` string, required
      - `destination_blocks` string[], required
  - OrderBundleWaitV2
    - `state` 'pending' | 'needs_review', required
    - `reason` string, required

## Other responses

- `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `403`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `409`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.

---

[API](https://skmtc.dev/arbital/apis/arbital-api.md) - [All operations](https://skmtc.dev/arbital/apis/arbital-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arbital/apis/arbital-api/revisions/bb0185edf43a?raw)