What’s new in this API version?

This API is currently in beta with limited availability. If you want to participate, you can look here. If you have any questions or remarks that can improve this API, mail us at retailerapi-beta@bol.com. Updates to this beta will be communicated via our developers portal.

In version 11 of the Offer API, we have improved the following in contrast to version 10:

  • This API is now processing offer data synchronously. This means you do not need to implement the process status mechanism anymore. If you create, update or delete an offer, this request is executed immediately. However, processing this offer against bol platform policies is still asynchronous.

  • Your offers can now be retrieved via a paginated offers endpoint. This endpoint allows you to request up to 100 offers per page.

  • Updating (parts of) an offer is now possible via a PATCH endpoint. If you want to update multiple parts of an offer, you can now do this via 1 single request instead of multiple separate requests.

  • Support for refurbished items is added. You can now also create refurbished items with this new offer API.

  • Multi-country support has been added. If you want to sell this offer in both the Netherlands and Belgium, you can now do this via one single offer in case all the rest of the offer details are the same.

  • Feedback as to why an offer is offline is improved. If you want to know why your offer is marked as offline, you can now get these details via a separate endpoint.