Get started with the Retailer API

Thank you for choosing bol.com as a retail partner. This site will help you to set up your development environment and begin selling your goods on our marketplace.

Please make sure that you have read and understand the Terms of Service that apply to the Retailer API before connecting.

Authentication

Before you start, make sure you have a bol.com retailer account. You cannot connect to us without it. More detailed information on credentials and authentication regarding the API can be found here.

Base URL

The base URL for all your API connections is https://api.bol.com/retailer.

Developing your connections

You can now start automating a complete workflow for selling on bol.com. You can manage your products, offers, orders and shipments, retrieve and confirm cancellations, handle your returns, view your invoices, and even print your shipping labels.

Additionally, if you make use of Fulfillment By Bol.com, you can use API endpoints to manage this process.

Before you start, make sure you understand the key concepts of our data model and the process flow of selling on bol.com. Also, make sure that you adhere to our conventions when developing your connections.

To make development easier, you can use our standard Postman export. Please be aware that you need to update the public Postman environment first with your production API credentials.

By default, the Postman collection is pointing to the demo environment. If you wish to change this to the production environment, you can change the environment variable accordingly.

Building your checks

Since much of our processing is asynchronous, if you create for example an offer or shipment through the API, always use a process status request afterwards. This allows you to verify that the process was completed successfully.

Testing

We recommend that you test your bol.com API connections against our demo environment. This allows you to can test your API calls and add products without being shown live on the website.

All endpoints are represented in the demo environment, except where the response is a PDF.

Not a plug-and-play solution.

While all efforts have been made to simplify and standardize our partner integrations, bear in mind that we do not offer a plug-and-play solution. There are several ways to connect to bol.com, but all require knowledge of software development and programming.

There are, however, several third party plug-and-play solutions on the market which can be purchased or used on a subscription basis. We have listed a few of them on the website for retailers.