---
title: "Check an HTML Mode discount code"
method: POST
path: "/v3/pages/{page_unique_id}/discount-codes/check"
tags: ["HTML Mode Pages"]
---

# Check an HTML Mode discount code

`POST /v3/pages/{page_unique_id}/discount-codes/check`

Page-scoped public endpoint for HTML Mode discount validation. The discount context is evaluated against the authenticated path page.

## Request body

- PagePublicDiscountCodeCheckRequest — HTML Mode discount check payload used by `Scalev.checkout.validateDiscount(payload)`.
  - `code` string, required
  - `gross_revenue` union
    - string, nullable
    - number
  - `net_product_price` union
    - string, nullable
    - number
  - `shipping_cost` union
    - string, nullable
    - number
  - `payment_method` string
  - `domain` string, nullable — Browser hostname supplied by the runtime.

## Response `200`

Discount code validation result

- StorefrontDiscountCodeCheckResponse
  - `discount_code` StorefrontDiscountCode, required
    - `id` integer
    - `business_id` integer
    - `is_enabled` boolean
    - `code` string
    - `applied_to` string, nullable
    - `amount_type` string, nullable
    - `percentage` union
      - string, nullable
      - number
    - `is_max_amount` boolean
    - `max_amount` union
      - string, nullable
      - number
    - `amount` union
      - string, nullable
      - number
    - `is_usage_limit` boolean
    - `usage_limit` integer, nullable
    - `current_usage` integer, nullable
    - `is_expiry` boolean
    - `expiry_time` string, date-time, nullable
    - `is_limited_to_pages` boolean
    - `pages` object[]
    - `is_limited_to_payment_methods` boolean
    - `payment_methods` string[]
    - `is_minimum_revenue` boolean
    - `minimum_revenue` union
      - string, nullable
      - number
    - `inserted_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
  - `eligibility_details` object, required
  - `is_eligible` boolean, required
  - `discount_code_discount` union, required
    - string, nullable
    - number

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/scalev/apis/nexus-commerce-api.md) · [All operations](https://skmtc.net/scalev/apis/nexus-commerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalev/nexus-commerce-api/versions/4354959d76dc/schema)