Retrieve a promo code

Retrieves a promo code's object. You need to pass the unique impact.com promo code Id value that was returned upon promo code creation or when listing promo codes.

Parameters

No parameters.

Returns

Returns a single promo code object corresponding to the provided ID, including details about the program, advertiser, campaign, deal, and configuration settings like match mode and credit rule.

Example request

curl 'https://api.impact.com/Mediapartners/{AccountSID}/PromoCodes/<Id> \
  -X GET \
  -u '<AccountSID>:<AuthToken>' \
  -H 'Accept: application/json' \
  -G

Example Response

{
  "PromoCodes": [
    {
      "Id": 3467,
      "Code": "summer2026",
      "Uri": "/Mediapartners/2/Programs/688",
      "State": "ACTIVE",

      "Program": {
        "Id": 3646,
        "Name": "Summer Savings Program",
        "LogoUri": "/Mediapartners/0YrY7A9L/Campaigns/summer_logo.png",
        "Uri": "/Mediapartners/Ey/Campaigns/summer_savings"
      },

      "Advertiser": {
        "Id": 2320,
        "Name": "SummerStyle Co.",
        "Uri": "/Mediapartners/R/Advertisers/summerstyle"
      },

      "Deal": {
        "Id": 2836,
        "Name": "Summer Savings Deal",
        "Uri": "/Mediapartners/0NOn/Campaigns/18358/Deals/summer_savings_deal"
      },

      "MatchMode": "RE",
      "CreditRule": "INVOLVED",
      "CreatedDate": "2025-07-02T10:00:00+02:00",
      "StartDate": "2025-07-05T00:00:00+02:00",
      "EndDate": "2025-12-15T23:59:59+02:00"
    }
  ]
}