List Promotions

List all your live and upcoming promotions

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Retrieve all live or upcoming promotions available to you, grouped by the brand slug they belong to. Each brand key maps to an array of promotions that can apply to supported transaction types.

Promotions details can change after creation, the last_edited_at value reflects when any of the values in the promotion object payload were last changed.

The payload response lists only live and upcoming promotions. If a promotion is cancelled it will not appear in the payload

The priority field will only be populated if two or more promotions 'overlap' on brand and date and denomination. In such circumstances priority will have an integer value, and the promotion with the lower number will take priority.

Responses

502

Bad Gateway. No response body is returned.

504

Gateway Timeout. No response body is returned.

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json