Coupons
Get a list of coupons
Retrieves a paginated list of coupons in the environment.
get/api/v1/coupons
Query parameters
afterstring uuid
Return items that come after this cursor
beforestring uuid
Return items that come before this cursor
limitinteger
Maximum number of items to return
idstring
Filter by entity ID
statusstring[]
Filter by coupon status. Supports comma-separated values for multiple statuses
type'FIXED' | 'PERCENTAGE'
Filter by coupon type (FIXED or PERCENTAGE)
Filter by creation date using range operators: gt, gte, lt, lte
Headers
X-ACCOUNT-IDstring
Account ID — optional when authenticating with a user JWT (Bearer token); falls back to the user's first membership. Ignored for API-key auth.
X-ENVIRONMENT-IDstring
Environment ID — required when authenticating with a user JWT (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the key).
Response
A paginated list of coupon objects.