---
title: "Changes to Retrieve Promo Code"
method: GET
path: "/promo_codes/{id}"
---

# Changes to Retrieve Promo Code

`GET /promo_codes/{id}`

> 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` — 1 info
- **2026-08-04** `bdd0e2c70d58` — 8 breaking, 6 warning, 14 info

## Changes

- **2026-08-07** `f1020c3ecda4` — 1 info
  - added the optional property `error/code` to the response with the `404` status
- **2026-08-04** `bdd0e2c70d58` — 8 breaking, 6 warning, 14 info
  - added `#/components/schemas/PromoCodeProduct, subschema #2` to the `product` response property `oneOf` list for the response status `200`
  - the `created_at` response's property format changed from `date-time` to no format for status `200`
  - the `duration` response's property type changed from no type to `string` for status `200`
  - the `expires_at` response's property format changed from `date-time` to no format for status `200`
  - the `product` response's property type changed from `object, null` to no type for status `200`
  - removed the required property `company` from the response with the `200` status
  - removed the required property `product/id` from the response with the `200` status
  - removed the required property `product/title` from the response with the `200` status
  - deleted the `path` request parameter `id`
  - removed the optional property `error/code` from the response with the `404` status
  - removed the optional property `error/param` from the response with the `404` status
  - added the new `forever` enum value to the `duration` response property for the response status `200`
  - added the new `once` enum value to the `duration` response property for the response status `200`
  - added the new `repeating` enum value to the `duration` response property for the response status `200`
  - 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
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - 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 `duration` response property `oneOf` list for the response status `200`
  - added the required property `account` to the response with the `200` status
  - added the required property `metadata` to the response with the `200` status
  - added the required property `updated_at` to the response with the `200` status

---

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