---
title: "Get an order by id (v3 — amounts carry USD)."
method: GET
path: "/v3/get-order/{id}"
tags: ["v3"]
---

# Get an order by id (v3 — amounts carry USD).

`GET /v3/get-order/{id}`

## Path parameters

- `id` string, required

## Response `200`

Get order by order_id, source Bitcoin txid, or source EVM tx hash

- GatewayOrderInfoV3 — Gateway order info (v3) — v2 shape plus USD on every amount field.
  - `depositAddress` string, nullable
  - `dstInfo` OrderDestinationInfoV3, required — Destination info (v3) — adds `usd`.
    - `amount` string, required — The _estimated_ amount of the output token, as determined by create-order.
    - `chain` string, required
    - `token` string, required
    - `usd` string, nullable — USD value of the estimated output at order time.
  - `estimatedTimeInSecs` integer, nullable
  - `id` string, required
  - `srcInfo` ChainTxInfoV3, required — Source-chain tx info (v3) — adds `usd`.
    - `amount` string, required
    - `chain` string, required
    - `token` string, required
    - `txHash` string, nullable
    - `usd` string, nullable — USD value of `amount` at order time. Absent if no price feed was available.
  - `status` union, required — Gateway order status (v3) — mirrors v2 with USD-carrying transfer types.
    - object
      - `inProgress` object, required
        - `pending_btc_payment` PendingBtcPaymentV3 — Pending BTC payment (v3) — adds `usd`.
          - `amount` string, required
          - `txid` string, required
          - `usd` string, nullable — USD value of the pending BTC amount, derived from the order's input rate.
        - `refund_tx` TxInfo
          - `chain` string, required
          - `data` string, required
          - `to` string, required
          - `value` string, required
    - object
      - `failed` object, required
        - `refund_tx` TxInfo
          - `chain` string, required
          - `data` string, required
          - `to` string, required
          - `value` string, required
    - object
      - `success` object, required
        - `received_tokens` GatewayUserTokenTransferV3[], required
          - `amount` string, required
          - `chain` string, required
          - `token` string, required
          - `txHash` string, required
          - `usd` string, nullable — USD value of `amount` at the time the transfer settled.
    - object
      - `refunded` object, required
        - `refunded_tokens` GatewayUserTokenTransferV3[], required
          - `amount` string, required
          - `chain` string, required
          - `token` string, required
          - `txHash` string, required
          - `usd` string, nullable — USD value of `amount` at the time the transfer settled.
  - `timestamp` integer, required

## Other responses

- `400` — Invalid order ID
- `404` — Order not found

---

[API](https://skmtc.net/bob-collective/apis/bob-gateway-api.md) · [All operations](https://skmtc.net/bob-collective/apis/bob-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bob-collective/bob-gateway-api/revisions/5a00610487e4/schema)