Validate Coupon

GET

/api/v1/coupons/validate

• Production
• Local development

Preview a coupon without redeeming it.

Always answers HTTP 200: an unknown, expired or exhausted code is a normal outcome of typing in a form, not a server error, and returning the same status for every outcome keeps the endpoint from doubling as a code oracle.

Args: code: The coupon code to preview (any case). session: Database session. _rate_limit: Per-IP rate-limit guard (injected).

Returns: {valid, code?, plan_grant?, discount_type?, discount_value?, bonus_credits?, description?, error?}.

Authorizations

• ApiKeyAuth

Parameters

Query Parameters

code

required

Coupon code

string

>= 1 characters <= 50 characters

Coupon code

Responses

200

Successful Response

GET /api/v1/coupons/validate response body (public, read-only).

Deliberately narrow: it echoes only what the signup form needs to render a badge. It never exposes max_redemptions, times_redeemed, or created_by — an unauthenticated caller should not be able to enumerate coupon economics by probing codes.

object

bonus_credits

Any of:

integer

integer

null

null

code

Any of:

string

string

null

null

description

Any of:

string

string

null

null

discount_type

Any of:

string

string

null

null

discount_value

Any of:

integer

integer

null

null

error

Any of:

string

string

null

null

error_code

Any of:

string

string

null

null

plan_grant

Any of:

string

string

null

null

valid

required

boolean

422

Validation Error

object

detail

Array<object>

object

ctx

object

input

loc

required

Array

msg

required

string

type

required

string