Economic Operators

Economic Operators API

In accordance with the Digital Services Act, bol must show consumers who is the responsible economic operator in the EU for a product before they purchase it. Every retailer is individually responsible for providing the required economic operator information.

The Economic Operator API allows you to create and manage your economic operators. It enables you to perform operations like creating, retrieving, updating and deleting of economic operators. Every retailer must do this for themselves. Economic operators are not shared between retailer accounts.

These economic operators can be linked to the offers for which they are the responsible economic operator in the EU. For more information, see linking economic operators to offers.

From 1 February 2025 bol will start enforcing that offers must have a VALID economic operator linked to them.

The economic operators API contains the following endpoints:

Create a new economic operator

Create a new economic operator - Allows you to create a new economic operator using the POST request.

Economic operators can be created using either the Seller Dashboard or through the Retailer API.

All retailers must create their own economic operators.

Each economic operator created is unique to its retailer and is assigned a distinct economicOperatorId at the time of creation. This ID serves as the key identifier for that specific operator.

Retrieve a specific economic operator

Retrieve a specific economic operator - Allows you to retrieve all information of a economic operator corresponding to the economic operator id provided.

An economic operator has a status that can be either VALID or INVALID. Bol will change this status if required. From 1 February 2025, bol will enforce that offers must have a VALID economic operator linked to them.

Update an economic operator

Update an economic operator - Allows you to update the following details of the specified economic operator:

  • externalReference - A user-defined identifier that can be used to reference bol’s economic operator id to another identifier.

  • name - The name of the economic operator.

  • houseNumber - The house number of the economic operator.

  • country - The (ISO 3166-1 alpha-2) EU country code of the economic operator.

  • additionalAddressInfo - Optional additional address information of the economic operator.

  • city - The city of the economic operator.

  • street - The street of the economic operator.

  • postalCode - The postal code of the economic operator.

  • emailAddress - The email address of the economic operator.

  • phoneNumber - The phone number of the economic operator.

Delete an economic operator

Delete an economic operator - Allows you to permanently delete a specific economic operator.

From 1 February 2025 bol will start enforcing that offers must have a VALID economic operator linked to them. Deleting an economic operator that is still linked to offers may cause these offers to be unpublished. For more information, see Linking economic operators to offers.

Search for (all) your economic operators

Search for (all) your economic operators - Allows you to search for your economic operators. You can search for them all, or you can search for a (partial) match on name.

The name field is optional. If name is not provided in the request, the system will return all available economic operators. Including name field will filter the results to only (partially) match the specified name.