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

# List coupons

`GET /api/coupons`

Retrieve a paginated list of coupons.

## Query parameters

- `isActive` boolean
- `page` number
- `limit` number

## Response `200`

Paginated list of coupons

- PaginatedCouponResponse
  - `data` CouponResponse[], required
    - `id` string, required
    - `code` string, required
    - `name` string, required
    - `description` string
    - `discountType` 'PERCENTAGE' | 'FIXED_AMOUNT', required
    - `discountValue` string, required — Discount value as decimal string
    - `currency` string
    - `maxRedemptions` number
    - `redemptionCount` number, required
    - `appliesToPlanIds` string[], required
    - `isActive` boolean, required
    - `expiresAt` string
    - `createdAt` string, required
    - `updatedAt` string, required
  - `meta` PaginationMeta, required
    - `total` number, required
    - `page` number, required
    - `limit` number, required
    - `totalPages` number, required

---

[API](https://skmtc.net/novabilling/apis/novabilling-api.md) · [All operations](https://skmtc.net/novabilling/apis/novabilling-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novabilling/novabilling-api/revisions/0e449a4e0dc8/schema)