List Promotions
Returns the promotions of one account, newest first, one page at a time, with an optional status filter.
GET
List Promotions
The list belongs to the account in the
X-Account-Code header. To see the promotions of several accounts, call once per account.
The list holds every promotion of the account: the CODE promotions you create with the API and the AUTOMATIC ones. Check redemption.mode to tell them apart.
Pages
Results come newest first, bycreated_at. A page holds up to limit promotions: 20 by default, 1 to 100 allowed. When more promotions exist, next_cursor is a string: pass it as cursor to read the next page. On the last page next_cursor is null. The cursor is opaque. A cursor that is not valid answers 400 INVALID_REQUEST with the message cursor: FORMAT.
Use status to keep one status: SCHEDULED, ACTIVE, EXPIRED or DISABLED. It accepts any case of the ASCII letters. Surrounding spaces are ignored, and a value of only spaces is read as no filter. Any other value, including one with a non-ASCII look-alike letter, answers 400 INVALID_REQUEST with status: UNKNOWN. Any other query parameter is ignored.Authorizations
Headers
The account_id found in your Yuno Dashboard (UUID). Required. A promotion belongs to one account, and this header names it. Omitting it returns 400 INVALID_PARAMETERS ("x-account-code header is required.").