Retrieve a promotion

Retrieves a promotion’s details. You need to pass the unique PromotionIds that was returned when listing promotions.


No parameters.


Returns a promotions object if a valid identifier is provided. Returns an error for invalid identifiers.

Example request

curl '<AccountSID>/Promotions/123456789' \ 
 -X GET \ 
 -u '<AccountSID>:<AuthToken>' \ 
 -H 'Accept: application/json'

Example response

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