---
title: "Get orders"
method: GET
path: "/trading/orders"
tags: ["Trading"]
---

# Get orders

`GET /trading/orders`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/trading/orders`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/trading/orders/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a paginated list of orders with optional filtering by account, provider, status, and time range.

Endpoint Permission: Owner, Admin, Non-Signing Admin, Signer, Approver, Editor, Viewer.

For detailed information about error codes and troubleshooting, please refer to our [API Error Codes documentation](https://developers.fireblocks.com/reference/api-error-codes).

## Query parameters

- `pageSize` integer, required
- `pageCursor` string
- `order` 'ASC' | 'DESC'
- `accountId` string[]
- `providerId` string[]
- `statuses` OrderStatus[]
- `startTime` integer
- `endTime` integer
- `assetConversionType` 'DIGITAL_ONLY' | 'FIAT': Filter by asset conversion type.

## Response `200`

Orders response

- GetOrdersResponse
  - `data` OrderSummary[], required
    - `id` string, required
    - `via` union, required: Response-only counterpart of AccessType. Used by the `via` field of response schemas (Quote, Rate, OrderDetails, OrderSummary — and therefore QuoteOffer, RateOffer and Offer) so that the PROVIDER variant can expose `subProviders` without that field ever becoming reachable from a request body. Request schemas (CreateOrderRequest.via) keep using AccessType.
      - AccountAccessResponse
        - `type` 'PROVIDER_ACCOUNT', required: Indicates this uses account-based access
        - `providerId` string: The ID of the provider
        - `accountId` string, required: The ID of the account
      - DirectAccessResponse: Response-only counterpart of DirectAccess. Adds the server-populated `subProviders` field. Never use this schema in a request body — requests must keep using DirectAccess (via AccessType).
        - `type` 'PROVIDER', required: Indicates this uses direct provider access
        - `providerId` string, required: The ID of the provider
        - `subProviders` string[]: The underlying providers or tools that this direct-access route is composed of, in execution order. Response-only: this field is populated by the server and is never accepted from client requests.
    - `side` 'BUY' | 'SELL', required: BUY: receive base / pay quote; SELL: give base / receive quote.
    - `baseAmount` string, required
    - `quoteAmount` string
    - `baseAssetId` string, required
    - `quoteAssetId` string, required
    - `status` 'CREATED' | 'AWAITING_PAYMENT' | 'AWAITING_INFORMATION' | 'PENDING_USER_ACTION' | 'PROCESSING' | 'CANCELED' | 'COMPLETED' | 'FAILED', required
    - `destination` union, required
      - InternalReference
        - `type` 'VAULT_ACCOUNT' | 'EXCHANGE_ACCOUNT' | 'UNMANAGED_WALLET' | 'FIAT_ACCOUNT' | 'CONNECTED_ACCOUNT', required
        - `accountId` string, required
      - OneTimeAddressReference
        - `type` 'ONE_TIME_ADDRESS', required
        - `address` string, required
        - `tag` string
    - `source` union
      - PlatformAccount
        - `type` 'VAULT_ACCOUNT' | 'CONNECTED_ACCOUNT' | 'FIAT_ACCOUNT', required
        - `accountId` string, required
      - ExternalAccount
        - `type` 'EXTERNAL', required
        - `senderInformation` union: Additional data for the external account, depending on the type used.
          - ExternalAccountMobileMoney
            - `type` 'MOBILE_MONEY_RAIL', required
            - `mobilePhoneNumber` string, required: Mobile phone number in E.164 format
            - `provider` 'M_PESA' | 'AIRTEL' | 'MTN' | 'TIGO' | 'ORANGE', required
            - `email` string, email, required
            - `successRedirectUrl` string: URL to redirect the end user back to after they complete the payment on the bank/mobile provider page (e.g., the merchant checkout page)
          - ExternalAccountLocalBankAfrica
            - `successRedirectUrl` string: URL to redirect the end user back to after they complete the payment on the bank/mobile provider page (e.g., the merchant checkout page)
    - `createdAt` string, date-time, required
  - `total` integer, required: Total number of orders matching the query.
  - `next` string: A cursor for the next page of results, if available.

## Other responses

- `401`: Unauthorized. Missing / invalid JWT token in Authorization header.
- `403`: Forbidden: insufficient permissions, disabled feature, or restricted access.
- `429`: Rate limit exceeded: slow down and retry later.
- `5XX`: Internal error while processing the request.
- `default`: Error Response

---

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