---
title: "List all coupons"
method: GET
path: "/coupons"
tags: ["Coupons"]
---

# List all coupons

`GET /coupons`

Returns a paginated list of coupons.

## Query parameters

- `status` 'active' | 'expired' | 'archived'
- `offset` integer
- `limit` integer

## Response `200`

List of coupons.

- CouponListPaged
  - `meta` object
    - `count` integer — The number of records returned as part of the response.
    - `offset` integer — The starting record number.
    - `limit` integer — The maximum number of records that can be returned as part of the response.
    - `total` integer — The total number of records contained in the query response.
    - `links` object[]
      - `rel` 'self' | 'first' | 'last' | 'prev' | 'next'
      - `href` string — Link to the resource which should be appended to base URL.
      - `title` string — Description of the link.
  - `data` Coupon[]
    - `id` string, required — Unique ID assigned by Acquired to the coupon when it is created.
    - `name` string, required — Display name for the coupon.
    - `discount_type` 'percentage' | 'fixed_amount', required — Whether the coupon applies a `percentage` or `fixed_amount` reduction.
    - `value` number, required — The discount value. For percentage: 20 = 20%, 100 = 100%. For fixed_amount: 5.00 = 5.00 in the specified currency.
    - `currency` 'GBP' | 'USD' | 'EUR', nullable — Required for fixed_amount discounts. Null for percentage discounts.
    - `duration` 'once' | 'repeating' | 'forever', required — How long the discount applies. 'once' applies to a single billing cycle, 'repeating' applies for a set number of cycles, 'forever' applies indefinitely.
    - `duration_in_cycles` integer, nullable — Number of billing cycles the discount applies for. Required when duration is 'repeating'. Null otherwise.
    - `max_redemptions` integer, nullable — Maximum number of times this coupon can be applied across all subscriptions. Null for unlimited.
    - `times_redeemed` integer, required — Number of times this coupon has been applied to subscriptions.
    - `status` 'active' | 'expired' | 'archived', required — Current lifecycle status of the coupon.
    - `created_at` string, date-time, required — When the coupon was created.
    - `links` object[], required
      - `rel` 'self'
      - `href` string — Link to the resource which should be appended to base URL.
      - `method` string — The HTTP method to use with the link.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

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