---
title: "Get user orders (v3 — amounts carry USD)."
method: GET
path: "/v3/get-orders/{user_address}"
tags: ["v3"]
---

# Get user orders (v3 — amounts carry USD).

`GET /v3/get-orders/{user_address}`

## Path parameters

- `user_address` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Get orders

- PaginatedOrdersResponseV3 — Paginated orders response (v3).
  - `nextCursor` string, nullable
  - `orders` GatewayOrderInfoV3[], required
    - `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 user address

---

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