Access tokens1

Account links1

Accounts20

Ad Campaigns9

Ad Conversion Value Rules7

Ad Groups10

Ad Pixels5

Ads8

Affiliates10

Ai chats5

API Keys7

Api Logs1

App Builds4

Apps8

Audiences5

Authorized users4

Bounties7

Bounty Submissions5

Cards6

Cashback Rules4

Chat channels3

Checkout Configurations4

Company token transactions3

Confirmation Tokens1

Course chapters5

Course lesson interactions2

Course lessons8

Course students2

Courses5

Deposits1

Dispute alerts2

Disputes6

Dm channels5

Dm members5

Domains6

Economic Intelligence2

Events4

Experiences8

Experiments8

Exports3

External Accounts10

Fee markups3

Feedback1

Files4

Forum posts4

Forums3

Identity profiles4

Invoices9

Leads4

Ledger accounts1

Ledgers3

Media2

Members5

Memberships13

Messages5

Notifications6

Partner Referral Requests6

Partners11

Payment Method Domains5

Payment methods3

Payment Quotes2

Payment Rules9

Payments14

Payout accounts1

Payout methods2

Payouts11

People2

Permissions1

Plans6

Product Affiliates1

Products7

Promo Codes6

Reactions4

Refunds2

Resolution Center Cases11

Reviews3

Setup Intents6

Shipments4

Social Accounts10

Stats6

Support channels3

Swaps4

Team Members5

Topups1

Trades3

Transfers6

Users18

Variants6

Verifications4

Waitlist Entries7

Webhooks9

Webhooks

Accounts4

Ad Campaigns2

Ad Groups1

Ads1

Cards13

Course lesson interactions1

Deposits1

Dispute alerts1

Disputes2

Entries4

Exports2

Invoices5

Ledger accounts1

Ledgers1

Members2

Memberships3

Messages1

Payments7

Payout accounts1

Payouts4

Products5

Reactions1

Refunds2

Resolution Center Cases3

Setup Intents3

Shipments2

Swaps1

Transfers3

Variants3

Verifications2

Promo Codes

List Promo Codes

Changed on Aug 7, 2026

Lists an account's promo codes.

get/promo_codes

Request

Base URL: https://api.whop.com/api/v1
URL: https://api.whop.com/api/v1/promo_codes
Auth: HTTP bearer

Query parameters

account_idstring required

Account whose promo codes are listed (biz_ tag).

status'active' | 'inactive' | 'archived' | 'expired'

Promo-code status. expired groups inactive and archived codes.

product_idsstring[]

Only promo codes scoped to these product IDs.

[
  "prod_xxxxxxxxxxxxxx"
]

plan_idsstring[]

Only promo codes scoped to these variant IDs.

[
  "plan_xxxxxxxxxxxxxx"
]

created_beforestring date-time

Only promo codes created before this ISO 8601 timestamp.

created_afterstring date-time

Only promo codes created after this ISO 8601 timestamp.

order'created_at'

Sort field.

direction'asc' | 'desc'

Sort direction.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

Response

promo codes listed

Example response

{
  "data": [
    {
      "amount_off": 0.1,
      "code": "welcome",
      "created_at": "2026-01-01T12:00:00.000Z",
      "currency": "usd",
      "duration": "repeating",
      "expires_at": "2026-01-01T12:00:00.000Z",
      "id": "promo_xxxxxxxxxxxxxx",
      "metadata": {},
      "new_users_only": true,
      "one_per_customer": true,
      "product": {
        "id": "prod_xxxxxxxxxxxxxx",
        "title": "Ceramic Coating Package"
      },
      "promo_duration_months": 1,
      "promo_type": "percentage",
      "status": "active",
      "stock": 25,
      "updated_at": "2026-01-01T12:00:00.000Z",
      "uses": 1
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

Aug 7, 2026f1020c3ecda4 Revision changes
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Aug 4, 2026bdd0e2c70d58 Revision changes
- breaking
  added the new required query request parameter account_id
- breaking
  the query request parameter status was restricted to a list of enum values
- breaking
  for the query request parameter first, default value 20 was added
- breaking
  added subschema #2 to the // response property oneOf list for the response status
- breaking
  the // response's property format changed from date-time to no format for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the // response's property format changed from date-time to no format for status
- breaking
  the // response's property type changed from object null to no type for status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- warning
  for the query request parameter first, the max was set to 100.00
- warning
  for the query request parameter last, the max was set to 100.00
- warning
  deleted the query request parameter company_id
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  added the new forever enum value to the // response property for the response status
- warning
  added the new once enum value to the // response property for the response status
- warning
  added the new repeating enum value to the // response property for the response status
- info
  api operation id listPromoCode removed and replaced with listPromoCodes
- info
  the security scope access_pass:basic:read was removed from the endpoint's security scheme bearerAuth
- info
  api tag Promo Codes added
- info
  api tag Promo codes removed
- info
  added the new optional header request parameter Api-Version-Date to all path's operations
- info
  added the new optional query request parameter direction
- info
  added the new optional query request parameter order
- info
  added the new enum value active to the query request parameter status
- info
  added the new enum value archived to the query request parameter status
- info
  added the new enum value expired to the query request parameter status
- info
  added the new enum value inactive to the query request parameter status
- info
  for the query request parameter status, the type was generalized from no type to string
- info
  removed the non-success response with the status
- info
  removed the non-success response with the status
- info
  removed the non-success response with the status
- info
  removed the non-success response with the status
- info
  removed subschema #2 from the // response property oneOf list for the response status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status

Operation history