List promotions

Returns a list of brand promotions available to you.

Parameters


No parameters.

Returns


Returns an array of promotion objects up to a limit dictated by @pagesize. Each entry in the array is a separate promotion. If no promotions meet the criteria, the resulting array will be empty. This request should never return an error.

Example request


curl 'https://api.impact.com/Mediapartners/<AccountSID>/Promotions \ 
 -X GET \ 
 -u '<AccountSID>:<AuthToken>' \ 
 -H 'Accept: application/json'

Example response


{ 
 "@page": "1", 
   ... 
     "Promotions": [
       {
         "AdvertiserId": "12345",
         "AdvertiserName": "ACME Inc",
         "AdvertiserLocation": "United States",
         "PromotionFileId": "37",
         "PromotionId": "123456789",
         "PromotionTitle": "Save 40% on Anvils with ACME Christmas",
         "PromotionEffectiveDates": "2022-12-13/2023-01-01",
         "GenericRedemptionCode": "ANVIL40",
         "PromotionItemsUri": "/Mediapartners/<AccountSID>/Catalogs/ItemSearch?Query=PromotionId='123456789'",
         "Uri": "/Mediapartners/<AccountSID>/Promotions/123456789"
       },
       { 
         ... 
       } 
   ]
}