---
title: "List discount codes (site admin)"
method: GET
path: "/discount-codes"
tags: ["Discount codes"]
---

# List discount codes (site admin)

`GET /discount-codes`

## Request

- Base URL: `https://app.pencil.ink/api/v1`
- URL: `https://app.pencil.ink/api/v1/discount-codes`
- Auth: HTTP bearer

Requires an explicitly enabled discount-management key whose creator remains a site admin and organization admin. Platform-wide. Returns offers, enabled, and nextCursor (null on the last page).

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

The resource.

- object
  - `data` DiscountCodePage
    - `offers` DiscountCode[]
      - `code` string: Unique code, 6–64 letters, digits, dashes or underscores; normalized to uppercase.
      - `label` string
      - `percentOff` integer
      - `duration` 'once' | 'repeating' | 'forever'
      - `months` integer: Required for repeating duration.
      - `planKey` 'pro' | 'team': USD monthly base subscription only; excludes AI usage.
      - `targetOrgId` string: Optional recipient organization. Recipient-targeted codes are single-use.
      - `targetUserId` string: Optional recipient user; mutually exclusive with targetOrgId.
      - `maxRedemptions` integer, nullable: Maximum distinct organization redemptions. Null means unlimited. Defaults to 1 and must be 1 for recipient-targeted codes.
      - `redeemFrom` number: Optional redemption start, Unix milliseconds.
      - `redeemBy` number: Optional future redemption deadline, Unix milliseconds.
      - `_id` string
      - `_creationTime` number
      - `active` boolean
      - `createdBy` string
      - `createdAt` number
    - `enabled` boolean
    - `nextCursor` string, nullable

## Other responses

- `400`: Malformed request or invalid field (`validation_error`).
- `401`: Missing or invalid API key (`unauthorized`).
- `403`: The key is read-only and may not write (`forbidden`).
- `429`: Rate limit exceeded (`rate_limited`).

---

[API](https://skmtc.dev/pencil/apis/pencil-public-api.md) · [All operations](https://skmtc.dev/pencil/apis/pencil-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pencil/apis/pencil-public-api/revisions/2b842698b76d?raw)