---
title: "Changes to List Shipments"
method: GET
path: "/shipments"
---

# Changes to List Shipments

`GET /shipments`

> Every recorded change to this endpoint, newest first.
> 74 revisions in range; 1 not diffed.

## Timeline

Changed in 5 of 74 revisions.

- **2026-09-16** `ff3a76573563` — 1 breaking, 2 warning
- **2026-08-08** `db0883548bc5` — 1 info
- **2026-08-07** `f1020c3ecda4` — 4 info
- **2026-07-31** `099fdc3be422` — 8 breaking, 10 warning, 17 info
- **2026-07-26** `60bbb4a6ffbc` — 1 breaking

## Changes

- **2026-09-16** `ff3a76573563` — 1 breaking, 2 warning
  - for the `query` request parameter `first`, default value `20` was added
  - for the `query` request parameter `first`, the max was set to `100.00`
  - for the `query` request parameter `last`, the max was set to `100.00`
- **2026-08-08** `db0883548bc5` — 1 info
  - added the required property `data/items/checkpoints` to the response with the `200` status
- **2026-08-07** `f1020c3ecda4` — 4 info
  - added the optional property `error/code` to the response with the `400` status
  - added the optional property `error/code` to the response with the `401` status
  - added the optional property `error/code` to the response with the `403` status
  - added the optional property `error/code` to the response with the `404` status
- **2026-07-31** `099fdc3be422` — 8 breaking, 10 warning, 17 info
  - for the `query` request parameter `payment_id`, the type changed from `string, null` to `array`
  - the `data/items/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `data/items/updated_at` response's property format changed from `date-time` to no format for status `200`
  - removed the required property `data/items/delivery_estimate` from the response with the `200` status
  - removed the required property `data/items/payment` from the response with the `200` status
  - removed the required property `data/items/service` from the response with the `200` status
  - removed the required property `data/items/substatus` from the response with the `200` status
  - removed the required property `data/items/tracking_code` from the response with the `200` status
  - deleted the `query` request parameter `company_id`
  - deleted the `query` request parameter `user_id`
  - removed the optional property `error/code` from the response with the `400` status
  - removed the optional property `error/code` from the response with the `401` status
  - removed the optional property `error/code` from the response with the `403` status
  - removed the optional property `error/code` from the response with the `404` status
  - removed the optional property `error/param` from the response with the `400` status
  - removed the optional property `error/param` from the response with the `401` status
  - removed the optional property `error/param` from the response with the `403` status
  - removed the optional property `error/param` from the response with the `404` status
  - api operation id `listShipment` removed and replaced with `listShipments`
  - the security scope `payment:basic:read` was removed from the endpoint's security scheme `bearerAuth`
  - added the new optional `header` request parameter `Api-Version-Date` to all path's operations
  - added the new optional `query` request parameter `account_id`
  - added the new optional `query` request parameter `created_after`
  - added the new optional `query` request parameter `created_before`
  - added the new optional `query` request parameter `direction`
  - added the new optional `query` request parameter `order`
  - added the new optional `query` request parameter `status`
  - removed the non-success response with the status `422`
  - removed the non-success response with the status `429`
  - removed the non-success response with the status `500`
  - added the required property `data/items/account_id` to the response with the `200` status
  - added the required property `data/items/carrier` to the response with the `200` status
  - added the required property `data/items/payment_id` to the response with the `200` status
  - added the required property `data/items/tracking_number` to the response with the `200` status
  - added the required property `data/items/tracking_url` to the response with the `200` status
- **2026-07-26** `60bbb4a6ffbc` — 1 breaking
  - removed the required property `data/items/carrier` from the response with the `200` status

---

[Operation](https://skmtc.dev/whop/apis/whop-api/docs/shipments/get.md) · [API](https://skmtc.dev/whop/apis/whop-api.md) · [Page](https://skmtc.dev/whop/apis/whop-api/changes/shipments/get)