Master the bol.com Retailer API v9. From authentication to product content, orders, and Fulfilment by Bol.com — the complete reference for Benelux marketplace integration.
Bol.com is the largest online marketplace in the Benelux region (Netherlands and Belgium), with over 13 million active customers and 52,000 sellers. The Retailer API is bol.com's official programmatic interface for managing your seller operations — from listing products and processing orders to managing fulfillment and tracking inventory.
The current version, Retailer API v9, uses RESTful conventions with JSON payloads. Unlike many marketplace APIs, bol.com's API is asynchronous for write operations — when you create or update an offer, you receive a process status ID rather than an immediate result. You then poll the process-status endpoint to check whether the operation succeeded. This architecture handles bol.com's catalog matching and content validation pipeline.
A key concept in the bol.com ecosystem is the separation between product content (the shared product page visible to buyers) and offers (your specific price, stock, and shipping terms). Multiple sellers can compete on the same product page by submitting offers against the same EAN. This model is similar to Amazon's ASIN system but uses EAN/GTIN as the canonical product identifier.
For international sellers, bol.com's API is well-documented and relatively stable, but the EAN-matching system, Dutch-language content requirements, and the FBB (Fulfilment by Bol.com) logistics flow introduce complexity that takes time to implement correctly. This guide walks through the essential concepts and endpoints you need for a working integration.
Last updated: March 2026
Bol.com uses a straightforward OAuth 2.0 Client Credentials flow. Unlike Allegro (which requires an Authorization Code flow for user-facing apps), bol.com issues credentials directly from the seller dashboard — no browser-based authorization redirect is needed.
client_id and client_secretAuthorization: Bearer <token> in all requestsAPI versioning header (required on all requests):
Accept: application/vnd.retailer.v9+jsonThe bol.com Retailer API base URL is https://api.bol.com. All write operations return a process-status ID that you must poll to confirm completion.
| Method | Endpoint | Description |
|---|---|---|
| POST | /retailer/auth/token | Obtain an access token (Client Credentials) |
| POST | /retailer/offers | Create a new offer for an existing product |
| PUT | /retailer/offers/{offer-id} | Update an existing offer (price, stock, shipping) |
| GET | /retailer/orders | List all orders with status filters |
| PUT | /retailer/orders/{order-id}/shipment | Ship an order with tracking info |
| POST | /retailer/content/products | Submit new product content (catalog creation) |
| GET | /retailer/content/products/{ean} | Retrieve product content by EAN |
| POST | /retailer/inbounds | Create an FBB inbound shipment |
| GET | /retailer/inventory | Retrieve inventory levels (FBB and FBR) |
| GET | /retailer/process-status/{id} | Check status of async operations |
Apply at partner.bol.com. You need a valid Dutch or Belgian KvK/BCE registration, a European bank account (IBAN), and VAT registration for the Netherlands. Approval typically takes 2-5 business days. International sellers must also provide a local return address in the Benelux.
In your seller dashboard, navigate to Settings then API Settings. Generate a client_id and client_secret pair. You can create multiple key pairs for different environments (production, staging). Store these credentials securely — they grant full access to your seller account.
POST to /retailer/auth/token with your credentials using Basic authentication. The returned access token is short-lived (typically 5-15 minutes). Implement automatic token refresh in your integration — request a new token before the current one expires.
Bol.com requires valid EAN-13 (GTIN) codes for every product. Check if your EANs already exist in the bol.com catalog using the Product Content API. For existing products, you only need to create an offer. For new products, you must submit full product content including Dutch-language title and description.
Use POST /retailer/offers with your EAN, price, stock quantity, fulfilment method (FBR or FBB), and shipping configuration. The API returns a process-status ID. Poll GET /retailer/process-status/{id} until the status is SUCCESS or FAILURE. Most offers activate within 15 minutes.
Poll GET /retailer/orders regularly to retrieve new orders. For FBR orders, you must ship within the promised delivery window and update the order with tracking information via PUT /retailer/orders/{id}/shipment. For FBB orders, bol.com handles fulfillment automatically.
Skip the EAN matching, async polling, and Dutch-language content requirements. Marqetir connects to bol.com's Retailer API and manages your listings automatically.
Free 7-day trial • No credit card required • Cancel anytime
Common questions about integrating with the bol.com Retailer API.