List coupons
Returns a list of coupons on the store. Requires the COUPONS_READ scope.
GET
https://api.pandabase.io/v2/core/stores/{storeId}/coupons/ Authentication
Requires a bearer token (sk_…) or an API key in the header Authorization.
Path parameters
storeId string required (length 12–48)
Query parameters
page integer default: 1(range 1–∞, defaults to 1)
limit integer default: 25(range 1–100, defaults to 25)
search string (length 0–128)
type enum No description.
enabled boolean No description.
sortBy enum No description.
sortOrder enum No description.
Header parameters
idempotency-key string (length 8–32)
Response 200
Default Response
ok enum required (one of true)
data object required No description.
Response 404
Default Response
ok enum required (one of false)
error string required No description.
Request
curl -X GET https://api.pandabase.io/v2/core/stores/:storeId/coupons/Response
{ "ok": true, "data": { "items": [ { "id": "cpn_p2v8q1mzj0kxw5h7n4tr3bcf", "code": "LAUNCH20", "displayName": "Launch week 20% off", "description": "Limited-time launch discount.", "type": "PERCENTAGE", "value": 20, "minimumPurchase": 1000, "maxUses": 500, "maxUsesPerCustomer": 1, "firstPurchaseOnly": false, "startsAt": "2026-05-01T00:00:00.000Z", "expiresAt": "2026-06-01T00:00:00.000Z", "enabled": true, "timesUsed": 42, "productIds": [], "createdAt": "2026-04-28T08:30:00.000Z", "updatedAt": "2026-05-12T11:15:00.000Z" } ], "pagination": { "page": 1, "limit": 25, "total": 1, "totalPages": 1 } }}