---
title: "List shipment items"
method: GET
path: "/shipments/{shipment_id}/items"
tags: ["Shipments"]
---

# List shipment items

`GET /shipments/{shipment_id}/items`

## Request

- Base URL: `https://api.whatnot.com/seller-api/rest/v2`
- URL: `https://api.whatnot.com/seller-api/rest/v2/shipments/{shipment_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 active shipment items newest first by default; set reverse=false for oldest first.

## Path parameters

- `shipment_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

- PageResponseShipmentItem
  - `data` ShipmentItem[], required: Results in the requested order.
    - `id` string, required: The shipment item's ID; distinct from its order-item ID.
    - `shipment_id` string, required: The ID of the shipment currently containing this item.
    - `order_id` string, nullable, required: The ID of the order associated with this item, if available.
    - `order_item_id` string, nullable, required: The ID of the order item associated with this shipment item, if available.
    - `dimension_profile` DimensionProfile, required: A dimension profile, also embedded in products and shipment items. On read, the resolved profile. On create, reference an existing profile by `id`, or supply `weight` and `dimensions` (with an optional `name`) to auto-create one.
      - `id` string, nullable: An existing dimension profile id to reference.
      - `name` string, nullable: The dimension profile's name. When auto-creating a profile this is used as a name prefix, with the weight and dimensions appended.
      - `weight` Weight
        - `value` number, required: The weight amount.
        - `unit` 'ounce' | 'pound' | 'gram' | 'kilogram', required: The unit used to express weight.
      - `dimensions` Dimensions
        - `length` number, required: The package length.
        - `width` number, required: The package width.
        - `height` number, required: The package height.
        - `unit` 'inch' | 'feet' | 'centimeter' | 'meter', required
      - `ownership` 'seller' | 'whatnot'
      - `active` boolean, nullable: Whether the dimension profile is active.
    - `hazardous_material` 'not_hazardous' | 'standard' | 'lithium_battery', required
    - `country_of_origin` string, nullable, required: Country of origin, if recorded.
    - `created_at` string, date-time, nullable, required: Creation timestamp, if recorded.
    - `updated_at` string, date-time, nullable, required: Last update timestamp, if recorded.
  - `next_cursor` string, nullable, required: Continuation cursor; null when there are no more results.

## Other responses

- `404`: Shipment 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)