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.