---
title: "Fetch All Coupons"
method: GET
path: "/v2/publishers/coupons"
tags: ["Coupon Codes"]
---

# Fetch All Coupons

`GET /v2/publishers/coupons`

## Request

- Base URL: `https://api.trackier.com`
- URL: `https://api.trackier.com/v2/publishers/coupons`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/trackier/apis/trackier-publisher-api-docs/docs/v2/publishers/coupons/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns all coupon codes for all campaigns

## Query parameters

- `pageToken` string
- `campaign_id` string

## Response `200`

Successful operation

- PublisherCouponCodeData
  - `coupons` object[]
    - `id` string
    - `code` string
    - `description` string
    - `status` 'active' | 'pending' | 'expired'
    - `type` 'generic' | 'exclusive' | 'one_time'
    - `campaign_name` string
    - `campaign_id` number
    - `start` string, date-time
    - `end` string, date-time
    - `created` string, date-time
  - `pageToken` string: Token to access next page

## Other responses

- `400`: Invalid API Key

## Changes

- **2025-06-13** (1.0.0) `165d9539d5df`: 2 info
  - added the optional property `coupons/items/end` to the response with the `200` status
  - added the optional property `coupons/items/start` to the response with the `200` status
- **2025-02-07** (1.0.0) `076fb3d89414`: 1 warning, 1 info
  - deleted the `query` request parameter `adid`
  - added the new optional `query` request parameter `campaign_id`
- **2025-02-06** (1.0.0) `2af1b26cfd71`: 1 info
  - added the new optional `query` request parameter `adid`
- **2024-03-20** (1.0.0) `08182eea5560`: 1 info
  - added the optional property `coupons/items/description` to the response with the `200` status
- **2024-03-19** (1.0.0) `c83de4fe6f7d`: 1 info
  - added the optional property `coupons/items/id` to the response with the `200` status

[Operation history](https://skmtc.dev/trackier/apis/trackier-publisher-api-docs/changes/v2/publishers/coupons/get.md)

---

[API](https://skmtc.dev/trackier/apis/trackier-publisher-api-docs.md) - [All operations](https://skmtc.dev/trackier/apis/trackier-publisher-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/trackier/apis/trackier-publisher-api-docs/revisions/662d56d3e6f1?raw)