---
title: "List All Promo Codes"
method: GET
path: "/Advertisers/{AccountSID}/PromoCodes"
tags: ["Promo Codes"]
---

# List All Promo Codes

`GET /Advertisers/{AccountSID}/PromoCodes`

Returns a list of your promo codes, with options for filtering by campaign, code, date, and state.

## Path parameters

- `AccountSID` string, required

## Query parameters

- `CampaignId` integer
- `Code` string
- `StartDate` string, date-time
- `EndDate` string, date-time
- `State` 'ACTIVE' | 'INACTIVE'

## Response `200`

A paginated list of promo code objects.

- object
  - `PromoCodes` PromoCode[] — The list of promo code objects.
    - `Id` integer — The unique identifier for the promo code.
    - `Code` string — The promo code value.
    - `Type` 'LI' | 'RE' — LI for Exact match, RE for Regex.
    - `CreditPolicy` 'ALWAYS' | 'INVOLVED' | 'WINNER' — How credit is awarded for actions involving this code.
    - `CampaignId` integer — The unique identifier of the program this promo code applies to.
    - `CampaignName` string — The display name of the program.
    - `AssignedPartnerId` integer — The unique identifier of the partner this promo code is assigned to.
    - `AssignedPartnerName` string — The display name of the assigned partner.
    - `CreatedDate` string, date-time — The date and time the promo code was created.
    - `StartDate` string, date-time, nullable — The date and time the promo code becomes active.
    - `EndDate` string, date-time, nullable — The date and time the promo code expires.
    - `State` 'ACTIVE' | 'INACTIVE' — The current state of the promo code.
    - `DealId` integer, nullable — The unique identifier of the Deal this promo code is linked to, if any.
    - `DealName` string, nullable — The display name of the linked Deal.
    - `DealState` string, nullable — The state of the linked Deal.
    - `DealType` string, nullable — The type of the linked Deal.
    - `DealScope` string, nullable — The scope of the linked Deal.
    - `DealStartDate` string, date-time, nullable — The start date of the linked Deal.
    - `DealEndDate` string, date-time, nullable — The end date of the linked Deal.
    - `DiscountType` string, nullable — How the discount is calculated.
    - `DiscountAmount` number, nullable — The flat discount amount, when DiscountType is FIXED.
    - `DiscountCurrency` string, nullable — Three-letter ISO 4217 currency code for the discount.
    - `DiscountPercent` number, float, nullable — The discount percentage, when DiscountType is PERCENT.
    - `MinimumPurchaseAmount` number, nullable — The minimum order amount required for the deal to apply.
    - `MaximumSavingsAmount` number, nullable — The maximum total savings the deal can apply to a single order.
    - `PurchaseLimitQuantity` integer — Maximum number of times the deal can be applied per order.
    - `BogoBuyQuantity` integer — Quantity the customer must buy in a BOGO deal.
    - `BogoBuyName` string, nullable — Name of the item the customer must buy in a BOGO deal.
    - `BogoGetQuantity` integer — Quantity the customer receives in a BOGO deal.
    - `BogoGetName` string, nullable — Name of the item the customer receives in a BOGO deal.
    - `BogoGetDiscountType` string, nullable — How the discount on the "get" item is calculated in a BOGO deal.
    - `SynchAdsPromoCodes` boolean — Whether to synchronize promo codes with ads.
    - `Uri` string, uri-reference — The unique reference to this promo code in the impact.com API.

---

[API](https://skmtc.net/impact/apis/brand-api-account-information.md) · [All operations](https://skmtc.net/impact/apis/brand-api-account-information/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/impact/brand-api-account-information/revisions/c53422ebb833/schema)