---
title: "List discount codes"
method: GET
path: "/v3/discount-codes"
tags: ["Discounts"]
---

# List discount codes

`GET /v3/discount-codes`

Business-scoped discount-code list ordered by discount-code ID descending. Supports code search plus `applied_to` and enabled-status filters. Results use v3 cursor pagination.

## Query parameters

- `page_size` integer
- `next_cursor` string
- `previous_cursor` string
- `search` string
- `applied_to` 'product_price' | 'shipping_cost'
- `status` 'enabled' | 'disabled'

## Response `200`

Paginated discount-code list

- DiscountCodeCollectionResponseBody
  - `data` DiscountCode[], 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
  - `is_paginated` true, required
  - `has_next` boolean
  - `has_previous` boolean
  - `next_cursor` string, nullable
  - `previous_cursor` string, nullable
  - `page_size` integer

## Other responses

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

---

[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/revisions/730030bd6477/schema)