Rebates and promotions
Get the user's list of promotions
Get a list of promotions defined by the authorized user and filtered by promotion type.
<p>Restrictions:</p> <p>Filtering by promotion type is required.</p> <p>Sum of limit and offset must be equal to or lower than 50000. Limit must be equal to or lower than 5000.</p> <p>Example:</p> <p>offset = 49950 and limit = 50 will return promotions</p> <p>offset = 49950 and limit = 51 will return 422 http error</p> <p>offset = 0 and limit = 5000 will return promotions</p> <p>offset = 0 and limit = 5001 will return 422 http error</p> <p>Read more about: Large order discount <a href="../../tutorials/jak-zarzadzac-rabatami-promocjami-yPya2mj6zUP#pobierz-dostepne-rabaty" target="_blank">PL</a> / <a href="../../tutorials/how-to-manage-rebates-and-promotions-g05avdL0vT4#retrieve-large-order-discount" target="_blank">EN</a>, Wholesale price list <a href="../../tutorials/jak-zarzadzac-rabatami-promocjami-yPya2mj6zUP#pobierz-dostepne-cenniki" target="_blank">PL</a> / <a href="../../tutorials/how-to-manage-rebates-and-promotions-g05avdL0vT4#retrieve-wholesale-price-lists" target="_blank">EN</a>, Multipack <a href="../../tutorials/jak-zarzadzac-rabatami-promocjami-yPya2mj6zUP#pobierz-dostepne-rabaty-ilosciowe" target="_blank">PL</a> / <a href="../../tutorials/how-to-manage-rebates-and-promotions-g05avdL0vT4#retrieve-promotional-sets" target="_blank">EN</a>.</p>get/sale/loyalty/promotions
Request
- Base URL: https://api.allegro.pl
- URL: https://api.allegro.pl/sale/loyalty/promotions
- Auth: OAuth 2 (authorization code, authorization URL https://allegro.pl/auth/oauth/authorize, token URL https://allegro.pl/auth/oauth/token, scopes: allegro:api:sale:offers:read)
Query parameters
limitinteger
Limit of promotions per page.
offsetinteger
Distance between the beginning of the document and the point from which promotions are returned.
offer.idstring
Filter by offer id. No promotions with OFFERS_ASSIGNED_EXTERNALLY or ALL_OFFERS criteria will be returned if this parameter is present.
promotionType'MULTIPACK' | 'CROSS_MULTIPACK' | 'LARGE_ORDER_DISCOUNT' | 'WHOLESALE_PRICE_LIST' required
Filter by promotion type.
Headers
Accept-Language'en-US' | 'pl-PL' | 'uk-UA' | 'sk-SK' | 'cs-CZ' | 'hu-HU' BCP-47 language code
Expected language of messages.
Response
Successfully returned the requested list of promotions
Changes
No recorded changes to this operation across all 1 revision of this API.