List Promo Codes
Lists promo codes for an account with cursor pagination, filters, and sorting.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
Pins the request to a dated API version.
"2026-09-29"
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 variant 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 results to return from the start of the range.
x <= 100Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.
Number of results to return from the end of the range.
x <= 100Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

