Get coupon

Retrieves a coupon by ID. Requires the COUPONS_READ scope.

GET https://api.pandabase.io/v2/core/stores/{storeId}/coupons/{couponId}

Authentication

Requires a bearer token (sk_…) or an API key in the header Authorization.

Path parameters

storeId string required

(length 12–48)

couponId string required

(length 12–48)

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/:couponId

Response

{  "ok": true,  "data": {    "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"  }}