WHwhatnot
Orders

List orders

List orders newest first by default; set reverse=false for oldest first. Offers that were never accepted aren't listed. Requires read: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

Query parameters

limitinteger

Maximum results per page.

cursorstring nullable

Cursor from the previous page.

reverseboolean

Return descending order when true; ascending when false.

Response

Successful Response

next_cursorstring nullable required

Continuation cursor; null when there are no more results.

Example response

{
  "data": [
    {
      "amounts": {
        "applied_discount": {
          "amount": {
            "amount": "2",
            "currency": "USD"
          },
          "type": "fixed_price"
        },
        "shipping": {
          "amount": "5.99",
          "currency": "USD"
        },
        "subtotal": {
          "amount": "42",
          "currency": "USD"
        },
        "tax": {
          "amount": "3.78",
          "currency": "USD"
        },
        "total": {
          "amount": "49.77",
          "currency": "USD"
        }
      },
      "buyer": {
        "display_name": "Card Collector",
        "id": "6789",
        "username": "cardcollector"
      },
      "created_at": "2026-09-21T12:00:00.000Z",
      "id": "123456",
      "show_id": "0b6f3c1e-8a52-4d2e-9f7a-3c5d1e2f4a6b",
      "status": "pending_fulfillment",
      "transaction_type": "auction",
      "updated_at": "2026-09-21T13:00:00.000Z",
      "url": "https://www.whatnot.com/dashboard/orders/5f0c2b7e-1d3a-4c6b-9e8f-7a6b5c4d3e2f"
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.