PHPackages                             jeffrey-kroonen/bol-retailer-api-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. jeffrey-kroonen/bol-retailer-api-php

ActiveLibrary[API Development](/categories/api)

jeffrey-kroonen/bol-retailer-api-php
====================================

A PHP Client to interact with the Bol.com Retailer API

v3.0.1(2y ago)232MITPHP

Since Aug 27Pushed 2y ago1 watchersCompare

[ Source](https://github.com/jeffrey-kroonen/bol-retailer-api-php)[ Packagist](https://packagist.org/packages/jeffrey-kroonen/bol-retailer-api-php)[ RSS](/packages/jeffrey-kroonen-bol-retailer-api-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (10)Versions (12)Used By (0)

[![PHPUnit](https://camo.githubusercontent.com/f0777ce06095878f212bc6b75803b01ea1a177b10a93aa2bec7aeee65aa0e9c1/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e742e7376673f75726c3d6874747073253341253246253246616374696f6e732d62616467652e6174726f782e6465762532466a6566667265792d6b726f6f6e656e253246626f6c2d72657461696c65722d6170692d70687025324662616467652533467265662533446d61696e266c6162656c3d504850556e6974267374796c653d666f722d7468652d6261646765)](https://actions-badge.atrox.dev/jeffrey-kroonen/bol-retailer-api-php/goto?ref=main)[![GitHub issues](https://camo.githubusercontent.com/fa38a62c7841b514b6d20e14aced966bb03570a43bb5d5ef76a6148e1a719307/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6a6566667265792d6b726f6f6e656e2f626f6c2d72657461696c65722d6170692d7068703f7374796c653d666f722d7468652d6261646765)](https://github.com/jeffrey-kroonen/bol-retailer-api-php/issues)[![GitHub forks](https://camo.githubusercontent.com/82aa5a1fce707b5ef7955be9aa81d8643f7f26b79d9208f0df64be380aa9b52b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6a6566667265792d6b726f6f6e656e2f626f6c2d72657461696c65722d6170692d7068703f7374796c653d666f722d7468652d6261646765)](https://github.com/jeffrey-kroonen/bol-retailer-api-php/network)[![GitHub stars](https://camo.githubusercontent.com/21b8ad76a90654faf1e12c16ee5b52021ec2c23bd3e569ef8d1719cc6340cdc3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6a6566667265792d6b726f6f6e656e2f626f6c2d72657461696c65722d6170692d7068703f7374796c653d666f722d7468652d6261646765)](https://github.com/jeffrey-kroonen/bol-retailer-api-php/stargazers)[![GitHub](https://camo.githubusercontent.com/8ab12776f41389193e67286ca3b709820e3cbb0305130b2ba53eeec7d80ae132/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6a6566667265792d6b726f6f6e656e2f626f6c2d72657461696c65722d6170692d7068703f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/8ab12776f41389193e67286ca3b709820e3cbb0305130b2ba53eeec7d80ae132/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6a6566667265792d6b726f6f6e656e2f626f6c2d72657461696c65722d6170692d7068703f7374796c653d666f722d7468652d6261646765)

###  Bol.com Retailer API PHP

[](#----bolcom-retailer-api-php)

 A PHP Client to interact with the Bol.com Retailer API v8

About the project
-----------------

[](#about-the-project)

The project is built with php v8.1.4 and is not complete. Only the endpoints I needed for my project are included in this project. Their will be no future releases coming from my side, besides when the Bol.com Retailer API releases a new version or if I have to make use of more endpoints.

Feel free to fork this project and [contribute](#Contributing) your work to improve the project.

### Supported endpoints

[](#supported-endpoints)

- Orders
- Returns
- Subscriptions
- Process status

Getting Started
---------------

[](#getting-started)

### Installation

[](#installation)

The project can be easily be installed through Composer

```
composer require jeffrey-kroonen/bol-retailer-api-php
```

Usage
-----

[](#usage)

Create a new instance of the `Client`

```
$client = new Client(
    bolClientId: '',
    bolClientSecret: ''
);
```

Authenticate at the Bol.com Retailer API

```
$client->authenticate();
```

After you have been authenticated at the Bol.com Retailer API, you can get the auth data, such as client id, client secret and access token. These data can be used in future requests. It's good practice to save the access token in your local database to reuse the next time

```
$client->getAuth();
```

Set The access token when instantiating `Client`

```
$client = new Client(
    bolClientId: '',
    bolClientSecret: '',
    accessToken: ''
);
```

Next you can call the [endpoint](https://api.bol.com/retailer/public/redoc/v7/retailer.html) you want to use

```
$ordersEndpoint = $client->orders();
```

Then you can call the methods available for that endpoint

```
$ordersEndpoint->orders(); // Retrieve a Paginate class instance containing orders
$ordersEndpoint->orderById(id: ''); // Retrieve an order by id
```

To get the data from the currently authenticated application, you can use the accessor on the `Client`

```
$client->getAuth(); // Returns an instance of Auth
```

You can get as example the Unix timestamp when the authentication will expire

```
$client->getAuth()->getExpiresIn(); // 1661613446
```

You will receive the exception `UnauthorizedException` when the request is no longer authorized. You can check manually when the authentication will expire

```
$client->isAuthenticated();
```

Contributing
------------

[](#contributing)

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~33 days

Recently: every ~46 days

Total

10

Last Release

1053d ago

Major Versions

v1.0.6 → v2.0.02022-10-15

v2.0.4 → v3.0.02023-02-15

### Community

Maintainers

![](https://www.gravatar.com/avatar/4aff1659ac996fb3cddabeadb3991c695d0b49334659120e2edae132e2e889a5?d=identicon)[jeffrey-kroonen](/maintainers/jeffrey-kroonen)

---

Top Contributors

[![jeffrey-kroonen](https://avatars.githubusercontent.com/u/51824309?v=4)](https://github.com/jeffrey-kroonen "jeffrey-kroonen (221 commits)")[![shops-united-jkroonen](https://avatars.githubusercontent.com/u/104895609?v=4)](https://github.com/shops-united-jkroonen "shops-united-jkroonen (24 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/jeffrey-kroonen-bol-retailer-api-php/health.svg)

```
[![Health](https://phpackages.com/badges/jeffrey-kroonen-bol-retailer-api-php/health.svg)](https://phpackages.com/packages/jeffrey-kroonen-bol-retailer-api-php)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.2M720](/packages/statamic-cms)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M650](/packages/sylius-sylius)[ashallendesign/laravel-exchange-rates

A wrapper package for interacting with the exchangeratesapi.io API.

485677.8k](/packages/ashallendesign-laravel-exchange-rates)[packbackbooks/lti-1p3-tool

A library used for building IMS-certified LTI 1.3 tool providers in PHP.

51438.3k2](/packages/packbackbooks-lti-1p3-tool)[concrete5/core

Concrete core subtree split

19159.3k48](/packages/concrete5-core)[hoels/app-store-server-library-php

The PHP server library for the App Store Server API and App Store Server Notifications.

44162.2k](/packages/hoels-app-store-server-library-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)