Validate a voucher code (pre-login)

Checks the status of a voucher code without redeeming it. Returns the voucher's current state — status (ACTIVE/REVOKED), valid, redemption_count, redemptions_remaining, and reason when invalid.

Anonymous: campaign is sourced from the x-campaign-id header so the storefront can verify a code during the signup flow before the user has a session. Voucher state is per-campaign rather than per-user, so no caller identity is required.

The route is throttled at 20 RPS steady / 50 burst at the API Gateway stage level to deter brute-force enumeration of the voucher code space. Callers exceeding the cap receive HTTP 429.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Check the status of a voucher code without redeeming it. Sent anonymously from the storefront (typically during the signup flow, before the user has a session). The campaign scope comes from the x-campaign-id header.

string
required
length ≥ 1

The voucher code to check.

Headers
uuid
required

Campaign scope for this request. Filters content to the specified campaign.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json