Get events about the seller's offers
Use this endpoint to get events from the last 24 hours concerning changes in the authorized seller's offers. At present we support the following events:
- OFFER_ACTIVATED - offer is visible on site and available for purchase, occurs when offer status changes from ACTIVATING to ACTIVE.
- OFFER_CHANGED - occurs when offer's fields have been changed e.g. description or photos, but does not apply to shipping rates and dispatch time.
- OFFER_ENDED - offer is no longer available for purchase, occurs when offer status changes from ACTIVE to ENDED.
- OFFER_STOCK_CHANGED - stock in an offer was changed either via purchase or by seller.
- OFFER_PRICE_CHANGED - occurs when price in an offer was changed.
- OFFER_ARCHIVED - offer is no longer available on listing and has been archived.
- OFFER_BID_PLACED - bid was placed on the offer.
- OFFER_BID_CANCELED - bid for offer was canceled.
- OFFER_TRANSLATION_UPDATED - translation of offer was updated.
- OFFER_VISIBILITY_CHANGED - visibility of offer was changed on marketplaces.
- OFFER_DELIVERY_COUNTRIES_BLOCKED - the offer has been blocked in selected countries.
Returned events may occur by actions made via browser or API. The resource allows you to get events concerning active offers and offers scheduled for activation (status ACTIVE and ACTIVATING). Returned events do not concern offers in INACTIVE and ENDED status (the exception is OFFER_ARCHIVED event). External id is returned for all event types except OFFER_BID_PLACED and OFFER_BID_CANCELED. Please note that one change may result in more than one event. Read more: <a href="../../tutorials/jak-zarzadzac-ofertami-7GzB2L37ase#dziennik-zdarzen-w-ofertach-sprzedawcy" target="_blank">PL</a> / <a href="../../tutorials/how-to-process-list-of-offers-m09BKA5v8H3#event-journal-concerning-changes-in-seller-s-offers" target="_blank">EN</a>.
Request
- Base URL: https://api.allegro.pl
- URL: https://api.allegro.pl/sale/offer-events
- 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
The ID of the last seen event. Events that occured after the given event will be returned.
The number of events that will be returned in the response.
The types of events that will be returned in the response. All types of events are returned by default.
Headers
Expected language of messages.
Response
The list of offer events returned successfully.
Changes
No recorded changes to this operation across all 1 revision of this API.