---
title: "Get an order by id (v2)."
method: GET
path: "/v2/get-order/{id}"
tags: ["v2"]
---

# Get an order by id (v2).

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

## Path parameters

- `id` string, required

## Response `200`

Get order by either the order_id returned by create-order, the source Bitcoin transaction ID , or the source EVM transaction hash

- GatewayOrderInfoV2 — Gateway order info (v2)
  - `depositAddress` string, nullable
  - `dstInfo` OrderDestinationInfo, required
    - `amount` string, required — The _estimated_ amount of the output token, as determined by initial create-order
    - `chain` string, required
    - `token` string, required
  - `estimatedTimeInSecs` integer, nullable
  - `id` string, required
  - `srcInfo` ChainTxInfo, required
    - `amount` string, required
    - `chain` string, required
    - `token` string, required
    - `txHash` string, nullable
  - `status` union, required
    - object
      - `inProgress` object, required
        - `pending_btc_payment` PendingBtcPayment
          - `amount` string, required
          - `txid` string, required
        - `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` GatewayUserTokenTransfer[], required
          - `amount` string, required
          - `chain` string, required
          - `token` string, required
          - `txHash` string, required
    - object
      - `refunded` object, required
        - `refunded_tokens` GatewayUserTokenTransfer[], required
          - `amount` string, required
          - `chain` string, required
          - `token` string, required
          - `txHash` string, required
  - `timestamp` integer, required

## Other responses

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

## Changes

- **2026-05-26** `ca0ef15d5879` — 1 breaking, 2 warning, 1 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9, subschema #10, subschema #11` to the `details/oneOf[#/components/schemas/GatewayErrorDetailsV2]/` response property `oneOf` list for the response status `400`
  - added the new `AFFILIATE_FEES_NOT_SUPPORTED_FOR_ROUTE` enum value to the `code/oneOf[#/components/schemas/GatewayErrorCodeV2Variants]/` response property for the response status `400`
  - added the new `UNKNOWN` enum value to the `code/oneOf[#/components/schemas/GatewayErrorCodeV2Variants]/` response property for the response status `400`
  - removed `#/components/schemas/GatewayErrorDetails, #/components/schemas/GatewayErrorDetailsV2Variants` from the `details/oneOf[#/components/schemas/GatewayErrorDetailsV2]/` response property `oneOf` list for the response status `400`
- …earlier changes not shown

[Full history](https://skmtc.dev/bob-collective/apis/bob-gateway-api/changes/v2/get-order/:id/get.md)

---

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