BillKit/Docs Console
Coupons

Validate coupon

Check whether a code is usable, and what it would take off.

POST/v1/coupons/validate
Operation validate_coupon · Scope coupons:read · Spec snapshot 2026-09-13

Parameters

ParameterDescription
codestringrequiredAt most 64 characters.
amount_centsinteger | nulloptionalMinimum 0.
price_idstring | nulloptionalNo description in the spec.

Returns

Returns a CouponValidateResponse object.

Errors

Status Cause
401 Missing or invalid API key.
403 Key is missing the coupons:read scope.
422 Validation Error
429 Rate limited. Back off and retry.
Request · curl 
curl -X POST https://api.billkit.eu/v1/coupons/validate \
  -H "Authorization: Bearer $BILLKIT_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"string"}'
Request body · every field 
{
  "amount_cents": 1900,
  "code": "string",
  "price_id": "price_9XKp2vQ1"
}
Response · 200 OK 
{
  "code": "string",
  "coupon_id": "coup_9XKp2vQ1",
  "discount_cents": 1900,
  "discount_type": "string",
  "discount_value": 0,
  "duration": "string",
  "final_charge_cents": 1900,
  "object": "coupon_validation",
  "reason": "string",
  "valid": false
}