v1
latestOpenAPI 3.0.32026-07-248079274.0 KBCoupons
List all coupons
Returns a paginated list of coupons.
get/coupons
Query parameters
status'active' | 'expired' | 'archived'
Filter by coupon status.
offsetinteger
The record to start the response on.
limitinteger
A limit on the scope of values returned in the response.
Response
List of coupons.
Example response
{
"meta": {
"links": [
{
"rel": "first",
"href": "/v1/path?offset=0",
"title": "first page"
}
]
},
"data": [
{
"id": "01JCX5Y8K9M3N4P6Q7R8S9T0UV",
"name": "Summer Sale 20%",
"discount_type": "percentage",
"value": 20,
"duration": "repeating",
"duration_in_cycles": 3,
"max_redemptions": 100,
"times_redeemed": 5,
"status": "active",
"links": [
{
"rel": "self",
"href": "/v1/coupons/01JCX5Y8K9M3N4P6Q7R8S9T0UV",
"method": "GET"
}
]
}
]
}