Back to overview

bol.com Retailer API v9: Live on 1st April 2023

Placed on:30 March 2023

A new version of the Retailer API has been released on 1st April 2023.

The Retailer API version 9 introduces eminent new features and significant improvements in the API.

New features:

Reporting - Following endpoints continue to remain in Beta and are now available in v10 (Beta) in the Reporting resource of the Advertiser API:

For more information on the aforementioned endpoints, see the functional documentation.

Shipments - Following endpoints continue to remain in Beta and are now available in v10 (Beta) in the Shipments resource of the Retailer API:

For more information on the aforementioned endpoints, see the functional documentation.

Insights - Following endpoint continues to remain in Beta and is now available in v10 (Beta) in the Insights resource of the Retailer API:

For more information on the aforementioned endpoint, see the functional documentation.

Products - Following endpoints moved out of Beta and are now available in v9 (GA) in the Products resource of the Retailer API:

For more information on the aforementioned endpoints, see the functional documentation.

Retailers - Following endpoints moved out of Beta and are now available in v9 (GA) in the Retailers resource of the Retailer API:

For more information on the aforementioned endpoints, see the functional documentation.

Improvements:

Invoices – Following endpoint includes changes in the response body of the API.

  • Get all invoices - The enum value for invoiceType field has been renamed from BOL_RETAIL_MEDIA_GROUP (BRMG) to ADVERTISING_VIA_BOL (Avb).

For more information on the aforementioned endpoints, see the functional documentation.

For more information about the overview of the changes, see v9 (GA) and v10 (Beta) Release Notes.

Upgrade from v8 to leverage the advantages of the enhanced designs and features in the new v9 API. For more information, see v8-v9 migration guides.