---
title: "List Coupon Codes"
method: GET
path: "/networks/couponcodes"
tags: ["Coupon Codes"]
---

# List Coupon Codes

`GET /networks/couponcodes`

## Query parameters

- `filter` string[]
- `relationship` 'offer' | 'affiliate'

## Response `200`

- object
  - `coupon_codes` CouponCode[]
    - `network_coupon_code_id` integer — Unique identifier for this coupon code.
    - `network_id` integer — The ID of the network this coupon code belongs to.
    - `network_affiliate_id` integer — ID of the affiliate for which the coupon applies. A coupon code without an affiliate specified can exist but cannot be used.
    - `network_offer_id` integer — ID of the offer for which the coupon applies.
    - `coupon_code` string — Coupon code value.
    - `coupon_status` 'active' | 'paused' — Status of the coupon code. Can be one of the following values: `active` or `paused`.
    - `internal_notes` string — Notes for internal usage -- they will not be visible to the partner.
    - `description` string — A description (either plain text or HTML) that will be visible to the partner.
    - `is_description_plain_text` boolean — Only relevant when a description is provided. Determines if the description is in HTML or plain text format.
    - `start_date` string — An optional date starting at which the coupon code can be used. Uses the YYYY-MM-DD format.
    - `end_date` string — An optional date at which the coupon code becomes obsolete. Uses the YYYY-MM-DD format.
    - `time_created` integer — Unix timestamp of when the coupon code was created.
    - `time_saved` integer — Unix timestamp of when the coupon code was last updated.
    - `time_deleted` integer — Unix timestamp of when the coupon code was deleted. 0 if not deleted.
    - `relationship` object — Related resources. Populated when the `relationship` query parameter is provided.
      - `offer` object
        - `network_offer_id` integer — Unique offer ID.
        - `network_id` integer — Network ID.
        - `name` string — Offer name.
        - `offer_status` string — Status of the offer.
      - `affiliate` object
        - `network_affiliate_id` integer — Unique affiliate ID.
        - `network_id` integer — Network ID.
        - `name` string — Affiliate name.
        - `account_status` string — Account status of the affiliate.

---

[API](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains.md) · [All operations](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/everflow/everflow-network-api-tracking-domains/revisions/39242cee0e32/schema)