---
title: "POST /v1/signup_page/coupon/validate"
method: POST
path: "/v1/signup_page/coupon/validate"
tags: ["signup"]
---

# POST /v1/signup_page/coupon/validate

`POST /v1/signup_page/coupon/validate`

## Request

- Base URL: `https://checkout-api.frisbii.com`
- URL: `https://checkout-api.frisbii.com/v1/signup_page/coupon/validate`
- Auth: none declared

## Request body

- ValidateCouponRequest
  - `code` string, required: The coupon code. Maximum 100 characters.
  - `product_handle` string, required: Product handle. Max length 255 with allowable characters [a-zA-Z0-9_.-@].
  - `account_id` string, required: Account ID. Max length 255 with allowable characters [a-zA-Z0-9_.-@].

## Response `200`

Successful operation

- CouponState
  - `active` boolean: Flag whether the coupon code is active or not.
  - `discountDto` Discount: Discount information related to the coupon code
    - `name` string, required: Name of discount. Will be used as order line text.
    - `description` string: Optional description of discount
    - `amount` integer: Fixed amount discount deducted from order line amounts including VAT, either amount or percentage should be provided
    - `currency` string: Currency for the discount plan in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) three letter alpha code
    - `percentage` integer: Percentage discount applied to each applicable order line, either amount or percentage should be provided
    - `handle` string, required: Per account unique handle for the discount
    - `metadata` object: Custom metadata.
    - `state` 'active' | 'deleted', required: Discount state `active` or `deleted`.
    - `deleted` string, date-time: Date when the discount was deleted if deleted. In ISO-8601 extended offset date-time format.
    - `created` string, date-time, required: Date when the discount was created. In ISO-8601 extended offset date-time format.
    - `apply_to` string[], required: Which order lines the discount is applicable to: `all`, `setup_fee`, `plan`, `additional_cost`, `add_on`, `ondemand` and `metered_billing_product`
    - `fixed_count` integer: Apply discount to a fixed number of invoices
    - `fixed_period_unit` 'months' | 'days': Time unit use for fixed valid period either `days` or `months`
    - `fixed_period` integer: Fixed period length e.g. 12 months or 14 days

## Other responses

- `400`: Invalid request, see error codes at https://api.frisbii.com/v1/error_codes
- `401`: None or invalid credentials provided in access to secured resource
- `403`: Not authorized to perform resource operation
- `404`: Resource or referenced resource not found, see error codes at https://api.frisbii.com/v1/error_codes
- `500`: Internal service error, error is reported automatically to Frisbii

---

[API](https://skmtc.dev/frisbii/apis/frisbii-checkout-api.md) - [All operations](https://skmtc.dev/frisbii/apis/frisbii-checkout-api/llms.txt) - [OpenAPI document](https://skmtc.dev/frisbii/apis/frisbii-checkout-api/revisions/43015ffd9dbb?raw)