List Promo Codes
Lists promo codes for an account with cursor pagination, filters, and sorting.
Authorizations
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
Pins the request to a dated API version.
"2026-08-03"
Query Parameters
Account whose promo codes are listed (biz_ tag).
Promo-code status. expired groups inactive and archived codes.
active, inactive, archived, expired Only promo codes scoped to these product IDs.
Only promo codes scoped to these plan IDs.
Only promo codes created before this ISO 8601 timestamp.
Only promo codes created after this ISO 8601 timestamp.
Sort field.
created_at Sort direction.
asc, desc Number of promo codes to return from the start of the window.
x <= 100Cursor to paginate forwards from.
Number of promo codes to return from the end of the window.
x <= 100Cursor to paginate backwards from.

