---
title: "List all coupon codes"
method: GET
path: "/coupons/{coupon_id}/codes"
tags: ["Coupons"]
---

# List all coupon codes

`GET /coupons/{coupon_id}/codes`

Returns all codes associated with a coupon.

**Note:** Use this endpoint to retrieve the full list of codes for
coupons with more than 1,000 codes. The `GET /coupons/{coupon_id}`
endpoint returns a maximum of 1,000 codes.

## Path parameters

- `coupon_id` string, required

## Response `200`

Successful response.

- CouponCodesResponse
  - `coupon` string — Path identifier of the coupon.
  - `codes` string[] — All coupon codes associated with the coupon. **Note:** Codes are normalized to uppercase on storage and are always returned in uppercase, regardless of the case used when they were submitted.

## Other responses

- `400` — Validation or request error. Returns `200 OK` — always check the `result` field rather than relying on the HTTP status code alone.

---

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