---
title: "List Coupons"
method: GET
path: "/v1/coupons"
---

# List Coupons

`GET /v1/coupons`

## Request

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

List the business's coupons, newest first. Uses page-number pagination. List items don't include `applies_to_ids`; get a single coupon for those.

## Query parameters

- `keywords` string
- `per_page` integer
- `page` integer

## Headers

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

## Response `200`

200

- object
  - `data` CouponListItem[]
    - `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
  - `links` object
  - `meta` object
    - `current_page` integer
    - `from` integer, nullable
    - `last_page` integer
    - `path` string
    - `per_page` integer
    - `to` integer, nullable
    - `total` integer

## Changes

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

[Operation history](https://skmtc.dev/hitpayapp/apis/hitpay-api/changes/v1/coupons/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)