---
title: "Get Coupon Details"
method: GET
path: "/v1/coupons/{coupon_id}"
---

# Get Coupon Details

`GET /v1/coupons/{coupon_id}`

## Request

- Base URL: `https://api.hit-pay.com`
- URL: `https://api.hit-pay.com/v1/coupons/{coupon_id}`
- Auth: none declared. Required headers: `X-BUSINESS-API-KEY`

Get a coupon, including the categories or products it applies to.

## Path parameters

- `coupon_id` string, uuid, required

## Headers

- `X-BUSINESS-API-KEY` string, required

## Response `200`

200

- Coupon
  - `id` string, uuid
  - `business_id` string, uuid
  - `name` string
  - `code` string
  - `fixed_amount` integer: Fixed discount in minor units (cents).
  - `percentage` number: Percentage discount as a fraction (`0.15` = 15%).
  - `coupons_left` integer, nullable: Remaining uses; `null` = unlimited.
  - `is_promo_banner` boolean
  - `banner_text` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `starts_at` string, date-time, nullable: UTC.
  - `ends_at` string, date-time, nullable: UTC.
  - `coupon_type` 1 | 2 | 3
  - `minimum_cart_amount` integer: Minimum cart amount in minor units (cents).
  - `deleted_at` string, date-time, nullable
  - `applies_to_ids` object[]: Categories or products the coupon applies to. Empty for `coupon_type` 1.
    - `id` string
    - `name` string

## Other responses

- `403`: The coupon belongs to another business
- `404`: Coupon not found

## Changes

- **2026-11-03** `fac86c13e845`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hitpayapp/apis/hitpay-api/changes/v1/coupons/:coupon_id/get.md)

---

[API](https://skmtc.dev/hitpayapp/apis/hitpay-api.md) - [All operations](https://skmtc.dev/hitpayapp/apis/hitpay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hitpayapp/apis/hitpay-api/revisions/fac86c13e845?raw)