Updated 2026-06-01
Store API: Coupons
List, validate, create, update, and delete coupons via the Store API.
The coupons resource supports validating a code (read-level) plus full CRUD for managing discount codes.
Coupon endpoints
GET
/v1/store/couponsList coupons. Filters: search, status.
Publishable keyGET
/v1/store/coupons/:idGet a single coupon.
Publishable keyPOST
/v1/store/couponsValidate a coupon (code + subtotal). Read-level — safe for checkout.
Publishable keyPOST
/v1/store/couponsCreate a coupon.
Secret keyPATCH
/v1/store/coupons/:idUpdate a coupon.
Secret keyDELETE
/v1/store/coupons/:idDelete a coupon.
Secret keyValidation is read-level
Coupon validation works with the publishable key, so you can validate codes during a headless checkout without exposing your secret key. The same endpoint with the secret key creates coupons.