Skip to main content
GET
JavaScript

Authorizations

Authorization
string
header
required

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-08-03"

Path Parameters

id
string
required

Promo code ID (promo_ tag).

Response

promo code retrieved

account
object
required

Account that owns the promo code.

amount_off
number
required

Discount amount. Percentage discounts are represented as a decimal fraction.

churned_users_only
boolean
required

Whether the promo code is restricted to churned customers.

code
string | null
required

Code entered at checkout.

created_at
string
required

When the promo code was created, as an ISO 8601 timestamp.

currency
enum<string>
required

Currency used for a fixed-amount discount.

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,
bgn,
idr,
dop,
php,
try,
krw,
twd,
vnd,
pkr,
clp,
uyu,
ars,
zar,
dzd,
tnd,
mad,
kes,
kwd,
jod,
all,
xcd,
amd,
bsd,
bhd,
bob,
bam,
khr,
crc,
xof,
egp,
etb,
gmd,
ghs,
gtq,
gyd,
ils,
jmd,
mop,
mga,
mur,
mdl,
mnt,
nad,
ngn,
mkd,
omr,
pyg,
pen,
qar,
rwf,
sar,
rsd,
lkr,
tzs,
ttd,
uzs,
rub,
btc,
cny,
usdt,
kzt,
awg,
whop_usd,
xau
Example:

"usd"

duration
enum<string>
required

How long the discount applies.

Available options:
forever,
once,
repeating
Example:

"forever"

existing_memberships_only
boolean
required

Whether the promo code applies only to existing memberships.

expires_at
string | null
required

When the promo code expires, as an ISO 8601 timestamp.

id
string
required

Promo code ID, prefixed promo_.

metadata
object
required

Custom key-value metadata stored on the promo code.

new_users_only
boolean
required

Whether the promo code is restricted to new customers.

one_per_customer
boolean
required

Whether each customer may redeem the promo code only once.

product
object | null
required

Product the promo code is restricted to, or null when it is not product-scoped.

promo_duration_months
integer | null
required

Billing intervals the discount applies to.

promo_type
enum<string>
required

Whether the discount is percentage-based or a fixed amount.

Available options:
percentage,
flat_amount
Example:

"percentage"

status
enum<string>
required

Promo code lifecycle status.

Available options:
active,
inactive,
archived
Example:

"active"

stock
integer
required

Maximum uses when stock is limited.

unlimited_stock
boolean
required

Whether the promo code has no redemption limit.

updated_at
string
required

When the promo code was updated, as an ISO 8601 timestamp.

uses
integer
required

Memberships that used the promo code.