---
title: "List order items"
method: GET
path: "/orders/{order_id}/items"
tags: ["Orders"]
---

# List order items

`GET /orders/{order_id}/items`

## Request

- Base URL: `https://api.whatnot.com/seller-api/rest/v2`
- URL: `https://api.whatnot.com/seller-api/rest/v2/orders/{order_id}/items`
- 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 an order's items newest first by default; set reverse=false for oldest first. Requires read:orders.

## Path parameters

- `order_id` string, required

## 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

- PageResponseOrderItem
  - `data` OrderItem[], required: Results in the requested order.
    - `id` string, required: The order item's ID.
    - `order_id` string, required: The ID of the order containing this item.
    - `product_id` string, nullable, required: The purchased product's ID, if known.
    - `variant_id` string, nullable, required: The purchased variant's ID, if the product has variants.
    - `product_external_id` string, nullable, required: The seller-provided external ID of the purchased product, if set.
    - `variant_external_id` string, nullable, required: The seller-provided external ID of the purchased variant, if set.
    - `purchased_item` PurchasedItem, required
      - `title` string, required: The item's title when it was purchased.
      - `description` string, nullable, required: The item's description when it was purchased, if set.
      - `sku` string, nullable, required: The item's SKU when it was purchased, if set.
    - `quantity` integer, required: The number of units purchased.
    - `unit_price` Money, required
      - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
      - `currency` string, required: ISO 4217 currency code.
    - `price_includes_tax` boolean, nullable, required: Whether unit_price includes tax, if recorded.
    - `shipment_id` string, nullable, required: The ID of the shipment currently containing this item, if any.
  - `next_cursor` string, nullable, required: Continuation cursor; null when there are no more results.

## Other responses

- `404`: Order not found.
- `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)