---
title: "Changes to List Memberships"
method: GET
path: "/memberships"
---

# Changes to List Memberships

`GET /memberships`

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

## Timeline

Changed in 4 of 74 revisions.

- **2026-09-25** `86b97292852d` — 4 info
- **2026-08-27** `16c82685be35` — 1 info
- **2026-08-07** `f1020c3ecda4` — 4 info
- **2026-07-26** `60bbb4a6ffbc` — 25 breaking, 17 warning, 25 info

## Changes

- **2026-09-25** `86b97292852d` — 4 info
  - added the required property `data/items/canceled_at` to the response with the `200` status
  - added the required property `data/items/cancellation_reason` to the response with the `200` status
  - added the required property `data/items/current_period_start` to the response with the `200` status
  - added the required property `data/items/manage_url` to the response with the `200` status
- **2026-08-27** `16c82685be35` — 1 info
  - added the required property `data/items/phone_number` 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-26** `60bbb4a6ffbc` — 25 breaking, 17 warning, 25 info
  - the `query` request parameter `direction` was restricted to a list of enum values
  - the `query` request parameter `order` was restricted to a list of enum values
  - for the `query` request parameter `direction`, default value `desc` was added
  - for the `query` request parameter `first`, default value `20` was added
  - for the `query` request parameter `order`, default value `created_at` was added
  - added `#/components/schemas/MembershipMember, subschema #2` to the `data/items/member` response property `oneOf` list for the response status `200`
  - the `data/items/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `data/items/member` response's property type changed from `object, null` to no type for status `200`
  - removed the required property `data/items/cancel_option` from the response with the `200` status
  - removed the required property `data/items/canceled_at` from the response with the `200` status
  - removed the required property `data/items/cancellation_reason` from the response with the `200` status
  - removed the required property `data/items/checkout_configuration_id` from the response with the `200` status
  - removed the required property `data/items/company` from the response with the `200` status
  - removed the required property `data/items/currency` from the response with the `200` status
  - removed the required property `data/items/joined_at` from the response with the `200` status
  - removed the required property `data/items/manage_url` from the response with the `200` status
  - removed the required property `data/items/member/id` from the response with the `200` status
  - removed the required property `data/items/payment_collection_paused` from the response with the `200` status
  - removed the required property `data/items/plan` from the response with the `200` status
  - removed the required property `data/items/product` from the response with the `200` status
  - removed the required property `data/items/promo_code` from the response with the `200` status
  - removed the required property `data/items/renewal_period_end` from the response with the `200` status
  - removed the required property `data/items/renewal_period_start` from the response with the `200` status
  - removed the required property `data/items/updated_at` from the response with the `200` status
  - removed the required property `data/items/user` from the response with the `200` status
  - 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`
  - deleted the `query` request parameter `cancel_options`
  - deleted the `query` request parameter `company_id`
  - deleted the `query` request parameter `plan_ids`
  - deleted the `query` request parameter `product_ids`
  - deleted the `query` request parameter `promo_code_ids`
  - deleted the `query` request parameter `statuses`
  - deleted the `query` request parameter `user_ids`
  - 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
  - …27 more

---

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