---
title: "List orders"
method: GET
path: "/orders"
tags: ["Orders"]
---

# List orders

`GET /orders`

## Request

- Base URL: `https://api.whatnot.com/seller-api/rest/v2`
- URL: `https://api.whatnot.com/seller-api/rest/v2/orders`
- Auth: OAuth 2
  - Authorization code: `https://api.whatnot.com/seller-api/rest/oauth/authorize`
  - Token URL: `https://api.whatnot.com/seller-api/rest/oauth/token`

List orders newest first by default; set reverse=false for oldest first. Offers that were never accepted aren't listed. Requires read:orders.

## Query parameters

- `limit` integer: Maximum results per page.
- `cursor` string, nullable: Cursor from the previous page.
- `reverse` boolean: Return descending order when true; ascending when false.

## Response `200`

Successful Response

- PageResponseOrder
  - `data` Order[], required: Results in the requested order.
    - `id` string, required: The order's ID.
    - `url` string, nullable, required: The url of the order in the seller's dashboard.
    - `status` 'pending' | 'pending_fulfillment' | 'completed' | 'cancelled' | 'failed', required
    - `show_id` string, nullable, required: The show the order was placed in; null for orders placed anywhere else.
    - `transaction_type` 'buy_it_now' | 'auction' | 'giveaway' | 'other', required
    - `buyer` UserSummary, required
      - `id` string, required: The user's decimal ID.
      - `username` string, required: The user's username.
      - `display_name` string, nullable, required: The user's display name.
    - `amounts` OrderAmounts, required
      - `subtotal` Money, required
        - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
        - `currency` string, required: ISO 4217 currency code.
      - `shipping` Money, required
        - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
        - `currency` string, required: ISO 4217 currency code.
      - `tax` Money, required
        - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
        - `currency` string, required: ISO 4217 currency code.
      - `applied_discount` union, required: The discount from the seller's coupon; null when none applied or the coupon isn't the seller's.
        - FixedPriceDiscount
          - `type` 'fixed_price', required: A fixed amount off the order.
          - `amount` Money, required
            - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
            - `currency` string, required: ISO 4217 currency code.
        - PercentageDiscount
          - `type` 'percentage', required: A percentage off the order.
          - `amount` Money, required
            - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
            - `currency` string, required: ISO 4217 currency code.
      - `total` Money, required
        - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
        - `currency` string, required: ISO 4217 currency code.
    - `created_at` string, date-time, nullable, required: Creation timestamp, if recorded.
    - `updated_at` string, date-time, nullable, required: Last update timestamp, if recorded.
    - `cancelled_at` string, date-time, nullable, required: When the order was cancelled, if it was.
  - `next_cursor` string, nullable, required: Continuation cursor; null when there are no more results.

## Other responses

- `422`: Invalid limit, cursor, or reverse flag.

---

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