---
title: "Changes to List Promo Codes"
method: GET
path: "/promo_codes"
---

# Changes to List Promo Codes

`GET /promo_codes`

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

## Timeline

Changed in 2 of 74 revisions.

- **2026-08-07** `f1020c3ecda4` — 3 info
- **2026-08-04** `bdd0e2c70d58` — 10 breaking, 12 warning, 19 info

## Changes

- **2026-08-07** `f1020c3ecda4` — 3 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 `404` status
- **2026-08-04** `bdd0e2c70d58` — 10 breaking, 12 warning, 19 info
  - added the new required `query` request parameter `account_id`
  - the `query` request parameter `status` was restricted to a list of enum values
  - for the `query` request parameter `first`, default value `20` was added
  - added `#/components/schemas/PromoCodeProduct, subschema #2` to the `data/items/product` 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/duration` response's property type changed from no type to `string` for status `200`
  - the `data/items/expires_at` response's property format changed from `date-time` to no format for status `200`
  - the `data/items/product` response's property type changed from `object, null` to no type for status `200`
  - removed the required property `data/items/product/id` from the response with the `200` status
  - removed the required property `data/items/product/title` 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 `company_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 `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 `404` status
  - added the new `forever` enum value to the `data/items/duration` response property for the response status `200`
  - added the new `once` enum value to the `data/items/duration` response property for the response status `200`
  - added the new `repeating` enum value to the `data/items/duration` response property for the response status `200`
  - api operation id `listPromoCode` removed and replaced with `listPromoCodes`
  - the security scope `access_pass:basic:read` was removed from the endpoint's security scheme `bearerAuth`
  - api tag `Promo Codes` added
  - api tag `Promo codes` removed
  - added the new optional `header` request parameter `Api-Version-Date` to all path's operations
  - added the new optional `query` request parameter `direction`
  - added the new optional `query` request parameter `order`
  - added the new enum value `active` to the `query` request parameter `status`
  - added the new enum value `archived` to the `query` request parameter `status`
  - added the new enum value `expired` to the `query` request parameter `status`
  - added the new enum value `inactive` to the `query` request parameter `status`
  - for the `query` request parameter `status`, the type was generalized from no type to `string`
  - removed the non-success response with the status `403`
  - 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`
  - removed `#/components/schemas/PromoDurations, subschema #2` from the `data/items/duration` response property `oneOf` list for the response status `200`
  - added the required property `data/items/metadata` to the response with the `200` status
  - …1 more

---

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