---
title: "Validate Promo Code"
method: GET
path: "/promo-codes/validate/{code}"
tags: ["promo-codes"]
---

# Validate Promo Code

`GET /promo-codes/validate/{code}`

Public signup-time promo code existence check.

This only confirms the entered code is in the enterable promo-code set.
It does not attach the code to a user or calculate booking discounts.

## Path parameters

- `code` string, required

## Response `200`

Successful Response

- ValidatePromoCodeResponse — Response from checking a signup promo code.
  - `exists` boolean, required
  - `code` string, nullable
  - `benefit_config` PromoCodeBenefitConfig — Machine-readable promo benefit configuration.
    - `category` string, required — Benefit type, e.g. percentage_discount, fixed_amount, flat_override
    - `amount` union, required — Discount amount for the category
      - integer
      - number
    - `metadata` object — Additional rule metadata for future promo engines
  - `message` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/helloaxel/apis/client-api-gateway.md) · [All operations](https://skmtc.dev/helloaxel/apis/client-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/helloaxel/client-api-gateway/revisions/d3c4c29fede7/schema)