WHwhatnot
Shipments

List shipments

Changed on

List shipments newest first by default; set reverse=false for oldest first.

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

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": [
    {
      "created_at": "2026-09-21T12:00:00.000Z",
      "dimensions": {
        "height": 1,
        "length": 6,
        "unit": "inch",
        "width": 4
      },
      "dropoff_due": "2026-09-23T07:00:00.000Z",
      "fulfillment_method": "shipping",
      "hazardous_material": "not_hazardous",
      "id": "12345",
      "insurance": {
        "amount": {
          "amount": "25.00",
          "currency": "USD"
        },
        "contents": "Trading cards"
      },
      "recipient": {
        "display_name": "Card Collector",
        "id": "6789",
        "username": "cardcollector"
      },
      "required_actions": [],
      "seller_paid_shipping_cost": {
        "amount": "5.99",
        "currency": "USD"
      },
      "signature_required": false,
      "status": "label_generated",
      "tracking": {
        "carrier": "usps",
        "service": "usps_ground_advantage",
        "tracking_code": "9400111899223100012345"
      },
      "updated_at": "2026-09-21T13:00:00.000Z",
      "url": "https://www.whatnot.com/dashboard/shipments/U2hpcG1lbnROb2RlOjUxMjU0MTM5Mw==",
      "weight": {
        "unit": "ounce",
        "value": 4
      }
    }
  ]
}

Changes

  • e619f15f7ce0Revision changes
    • info

      added the required property // to the response with the status