---
title: "Fetch all discount codes"
method: GET
path: "/api/v1/discount_codes"
tags: ["Discount Codes"]
---

# Fetch all discount codes

`GET /api/v1/discount_codes`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/discount_codes`
- Auth: none declared. Required headers: `Api-Key`

Returns the business's discount codes (coupons), ordered by code.

By default only **active** codes are returned — those that have not been deactivated and whose validity window includes today. Use the `visibility` parameter to return expired, deactivated, or all codes instead.

Each code describes how the discount is calculated (`adjust_based_on` of `flat_rate` or `percent`), what it applies to (`applies_to_type`), and its validity window. To apply a code to an event, use the event discount code endpoint.

**Required permission:** `offerings_read`

## Query parameters

- `visibility` string

## Headers

- `Api-Key` string, required

## Response `200`

discount codes found

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)