Coupons
Get Coupon by Code
Learn how to validate and query a coupon by code using the endpoint GET /stores//coupons/.
GET
Get coupon by code
📌 Endpoint
GET /stores/{storeId}/coupons/{code}
Fetches a coupon by its code for use at checkout.
🔐 Authentication
- Public route.
- The store must have an active plan.
🧾 Route parameters
🔎 Query params
✅ Example request
📦 Success response (200)
⚠️ Possible errors
400 INVALID_DATA→ invalid parameters400 COUPON_EXPIRED→ coupon expired400 COUPON_ALREADY_USED→ usage limit reached or customer (email/cpf) already used the coupon withSINGLE_USE_PER_CUSTOMER401 UNAUTHENTICATED→ unauthenticated403 NO_ACTIVE_SUBSCRIPTION→ inactive/expired plan404 STORE_NOT_FOUND→ store not found404 COUPON_NOT_FOUND→ coupon does not exist429 RATE_LIMIT_EXCEEDED→ per-minute rate limit exceeded500 INTERNAL_SERVER_ERROR→ internal server error503 SERVICE_UNAVAILABLE→ service unavailable