Finding a promo

Please make sure you read the Conventions before continuing with this guide.


You will need an X-API-KEY.

Finding a promo as a provider.

You will interact with the /inventory/promos endpoint of the Inventory Bucket to look up all the promos available to your account.

For being able to get all promos you must provide a backoffice valid channel. If you don't, you will get an error message.

This is the call you will use if you are a provider

You can get all promos available to your account by calling the promos endpoint like this.

Finding a promo as a seller

If you are a seller you will need to pass the promoCode in the promos endpoint, instead.

Parameter Type Example
promoCode String promo-code-000
channels String backoffice,websales, agency-backoffice, agency-websales