Whop Developers home page

Start Building
Start Building

Promo Codes

List Promo Codes

Documentation

API Reference

SDK Reference

Promo Codes

List Promo Codes

List all promo codes.

GET

promo_codes

Authorization

string

Authorization

string

Your API key, which can be found on the Whop Business Dashboard. You must prepend your key with the word 'Bearer', which will look like Bearer ***************************

page

integer

page

integer

The page number to retrieve

per

integer

per

integer

The number of resources to return per page. There is a limit of 50 results per page.

status

enum<string>

status

enum<string>

Indicates if the Promo Code is live, disabled, or archived.

expand

array

expand

array

Whether or not to expand the Plans on the returned Promo Code(s). Pass an array with each object(s) you want to expand, e.g. [plans]

Headers

Authorization

string

Your API key, which can be found on the Whop Business Dashboard. You must prepend your key with the word 'Bearer', which will look like Bearer ***************************

Query Parameters

page

integer

default: 1

The page number to retrieve

per

integer

default: 10

The number of resources to return per page. There is a limit of 50 results per page.

status

enum<string>

Indicates if the Promo Code is live, disabled, or archived.

Available options:

active,

inactive,

archived

expand

enum<string>[]

Whether or not to expand the Plans on the returned Promo Code(s). Pass an array with each object(s) you want to expand, e.g. [plans]

Available options:

plans,

promo_code

Response

200 - application/json

pagination

object

Pagination model

pagination.current_page

integer

The current page of the paginated response

pagination.total_page

integer

The total number of pages in the paginated response

pagination.total_count

integer

The total number of objects in the paginated response (automatically maxed out at 50)

data

object[]

data.id

string

The ID of the Promo Code, which will look like promo_*************

data.plans

string

The Plans this Promo Code is valid for. By default this will just be the IDs of the Plans, but you can expand it to get more information about the Plan by passing [plan] in the expand parameter.

data.amount_off

number

The amount off (percentage or flat amount) for the Promo Code.

data.base_currency

enum<string>

The monetary currency of the Promo Code.

Available options:

usd,

sgd,

inr,

aud,

brl,

cad,

dkk,

eur,

nok,

gbp,

sek,

chf,

hkd,

huf,

jpy,

mxn,

myr,

pln,

czk,

nzd,

aed,

eth,

ape,

cop,

ron,

thb

data.code

string

The specific code used to apply the Promo Code at checkout.

data.new_users_only

boolean

Restricts Promo Code use to users who haven't purchased from the company before.

data.number_of_intervals

integer

The number of billing cycles the Promo Code is applied for. By default, it is applied forever (0).

data.plan_ids

array

Please use plans instead, as this field is deprecated.

data.promo_type

enum<string>

Whether the Promo Code is a percentage or flat amount off.

Available options:

percentage,

flat_amount

data.status

enum<string>

Indicates if the Promo Code is live, disabled, or archived.

Available options:

active,

inactive,

archived

data.stock

integer

The number of total uses remaining for the Promo Code.

data.unlimited_stock

boolean

Whether or not the Promo Code has unlimited uses.

data.uses

integer

The amount of times the Promo Code has been used.

data.created_at

integer

The time at which the Promo Code was created. Measured in seconds since the Unix epoch.

data.expiration_datetime

integer

The date/time of when the Promo Code expires.

data.metadata

object

A polymorphic object containing information that can be user defined

data.duration

enum<string>

The duration setting for the promo code.

Available options:

forever,

once,

repeating

data.existing_memberships_only

boolean

If true, the promo code can only be applied to existing memberships (post checkout).

Was this page helpful?

Retrieve a Payment Retrieve a promo code

twitter github discord

API Documentation

Memberships

Products

Plans

Experiences

Checkout Sessions

Companies

Members

Payments

Promo Codes

Reviews

Webhooks

Headers

Query Parameters

Response