---
title: "List shipments"
method: GET
path: "/shipments"
tags: ["Shipments"]
---

# List shipments

`GET /shipments`

## Request

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

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

- PageResponseShipment
  - `data` Shipment[], required: Results in the requested order.
    - `id` string, required: The shipment's ID.
    - `url` string, required: The url of the shipment in the seller's dashboard.
    - `status` 'created' | 'label_generated' | 'dropped_off' | 'in_transit' | 'delivered' | 'failed' | 'cancelled' | 'cancelled_not_shipped' | 'cancelled_not_shipped_with_dropoff' | 'cancelled_tracking_stuck', required
    - `fulfillment_method` 'shipping' | 'pickup', required
    - `recipient` 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.
    - `weight` Weight, required
      - `value` number, required: The weight amount.
      - `unit` 'ounce' | 'pound' | 'gram' | 'kilogram', required: The unit used to express weight.
    - `dimensions` Dimensions, required
      - `length` number, required: The package length.
      - `width` number, required: The package width.
      - `height` number, required: The package height.
      - `unit` 'inch' | 'feet' | 'centimeter' | 'meter', required
    - `signature_required` boolean, required: Whether delivery requires a signature.
    - `hazardous_material` 'not_hazardous' | 'standard' | 'lithium_battery', required
    - `tracking` ShipmentTracking, required
      - `carrier` string, nullable, required: The carrier delivering this shipment.
      - `service` string, nullable, required: The carrier service used for this shipment.
      - `tracking_code` string, nullable, required: The carrier's tracking code for this shipment.
      - `last_mile_tracking_code` string, nullable, required: The tracking code used for the final leg of delivery.
    - `insurance` ShipmentInsurance, required
      - `amount` Money, required
        - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
        - `currency` string, required: ISO 4217 currency code.
      - `contents` string, nullable, required: Description of insured contents.
    - `seller_paid_shipping_cost` Money, required
      - `amount` string, required: Decimal amount in major currency units, e.g. 42.00.
      - `currency` string, required: ISO 4217 currency code.
    - `required_actions` ShipmentRequiredAction[], required: Actions required before fulfillment.
    - `dropoff_due` string, date-time, nullable, required: Due date at seller-local midnight, serialized with timezone; not the overdue cutoff. Null for pickup, non-pre-transit shipments, or missing inputs.
    - `replacement_shipment_id` string, nullable, required: Immediate successor shipment ID after replacement, bundling, or splitting; not the final successor in a chain.
    - `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

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

## Changes

- **2026-11-03** `e619f15f7ce0`: 1 info
  - added the required property `data/items/seller_paid_shipping_cost` to the response with the `200` status

[Operation history](https://skmtc.dev/whatnot/apis/whatnot-seller-api/changes/shipments/get.md)

---

[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)