Welcome to the Retailer API
This site offers a comprehensive guide to working with bol’s Retailer API and integrating your environment with our platform.
Please make sure that you have read and understood the Terms of Service that apply to the Retailer API before connecting.
Definition
The Retailer API refers to the combined set of API functions which we are offering to all business retailers that are registered on the bol retailer platform.
Step 1. Get a Retailer Account
Before you can start connecting you need to sign up for a retailer account. This will enable you to authenticate yourself and connect to the API.
Step 2. Choose an integration method
These guides will help you to develop your own custom solution to integrate your systems with our platform. However, there are also several third-party solutions that can make this process easier.
Step 3. Get to know the API
The following topics will familiarize you with the building blocks of developing against the Retailer API:
Step 4. Set up a demo environment
We recommend that you test your bol API connections against our demo environment. This demo describes test requests for users to validate that their API connection is working.
In addition, we offer a Postman export which should be updated with your production API credentials.
Step 5. Start building
Now you can start putting together the integration and begin making real sales! We recommend always starting your development with Offers, then moving to Orders, and after that start implementing the more advanced Content management.
We have also created some tutorial videos that can help you to get started developing with our API.
Service and legal
The following links explain your expectations from us and our legal requirements regarding the use of our Retailer API:
Migration guides and release notes
The comprehensive migration guides will help you with the migration from older versions of the API. In addition you can also review the release notes for each version.
Migration guides
Release notes
API Overview
APIs | Functional Documentation | API Reference |
---|---|---|
Reporting |
||
Commissions API |
||
Insights API |
||
Inventory API |
||
Invoices API |
||
Offers API |
||
Orders API |
||
Process Status API |
||
Product Content API |
||
Products |
||
Promotions API |
||
Replenishments API |
||
Retailers |
||
Returns API |
||
Shipments API |
||
Shipping Labels API |
||
Subscriptions API |
||
Transports API |
Retailer API versions
Below you can find version-specific documentation, containing API features that may differ between released versions.
Resource | Description | v8 (deprecated) | v9 (deprecated) | v10 |
---|---|---|---|---|
ApiSpec |
Swagger/OpenAPI spec for use in documentation tools and code generators. |
|||
API Reference documentation |
Technical documentation, based on Redoc. |
|||
Postman Suite |
Retailer API endpoints documented using Postman. Can be imported to the Postman app for easy execution. |
|||
Demo environment |
Documentation covering available endpoints in demo environment. |