List all voucher codes
Returns the company's voucher codes, newest first. Expired voucher codes are included; deleted ones are not.
Query Parameters
limit?integer
Number of results per page. Default 50, maximum 200. Values above 200 or zero/negative are clamped to that range rather than rejected.
Default
50next_cursor?string
Opaque pagination cursor returned in next_cursor of the previous response. Malformed values are ignored and the first page is returned.
Response Body
application/json
application/json
curl -X GET "https://example.com/voucher-codes" \ -H "Easol-API-Version: 2026-11-01"{
"object": "string",
"url": "string",
"has_more": true,
"next_cursor": "string",
"data": [
{
"id": "vc_aBcDeFgHiJ",
"object": "voucher_code",
"code": "SUMMER25",
"discount_type": "percentage",
"discount_percentage": 25,
"discount_amount": {
"amount": 0,
"currency": "string"
},
"bogof_purchase": 2,
"bogof_free": 1,
"redemption_limit": 100,
"redemptions": 12,
"minimum_quantity": 1,
"expires_on": "2026-12-31",
"applies_automatically": true,
"apply_to_all_products": true,
"status": "valid",
"variants": {
"object": "list",
"url": "string",
"has_more": false,
"next_cursor": "string",
"data": [
{
"id": "expv_aBcDeFgHiJ",
"object": "experience_variant",
"name": "Double room",
"tagline": "Sea view, breakfast included"
}
]
},
"date_ranges": {
"object": "list",
"url": "string",
"has_more": false,
"next_cursor": "string",
"data": [
{
"start_on": "2026-09-01",
"end_on": "2026-09-30"
}
]
}
}
]
}{
"error": {
"code": "string",
"message": "string"
}
}