PHPackages                             mstroink/overheid-io - 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. mstroink/overheid-io

ActiveLibrary[API Development](/categories/api)

mstroink/overheid-io
====================

Simple client for consuming OverheidIo API

v1.2.2(4y ago)21.8kPHPPHP &gt;=7.4CI failing

Since Jun 13Pushed 3y agoCompare

[ Source](https://github.com/mstroink/overheid-io)[ Packagist](https://packagist.org/packages/mstroink/overheid-io)[ Docs](https://github.com/mstroink/overheid-io)[ RSS](/packages/mstroink-overheid-io/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (5)Dependencies (4)Versions (6)Used By (0)

 [ ![Build Status](https://camo.githubusercontent.com/6d60656a641beb6b53d71e43ba5338f88392a97ac7f7446d7adee69b0b537ed6/68747470733a2f2f7472617669732d63692e636f6d2f6d7374726f696e6b2f6f766572686569642d696f2e7376673f6272616e63683d6d6173746572) ](https://travis-ci.com/mstroink/overheid-io) [ ![Coverage Status](https://camo.githubusercontent.com/1e19a67c5fe86c1b88d45b94c97cb38a44fd6827069d8fad10688b3804db86a1/68747470733a2f2f636f6465636f762e696f2f67682f6d7374726f696e6b2f6f766572686569642d696f2f6272616e63682f6d61737465722f67726170682f62616467652e737667) ](https://codecov.io/gh/mstroink/overheid-io) [ ![Stable](https://camo.githubusercontent.com/ee48016b0b12bf20249c5231a230f141c6c17a9147aa05e65c3d2d0ce48216b0/68747470733a2f2f706f7365722e707567782e6f72672f6d7374726f696e6b2f6f766572686569642d696f2f762f737461626c652e737667) ](https://packagist.org/packages/mstroink/overheid-io) [ ![php Version](https://camo.githubusercontent.com/bbc42a8ead70f1e58608ec2f73f07abbdb930ac54179c49f177b00de6d913d5c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d2533453d253230372e322d3838393242462e737667) ](https://php.net)

Simple PHP wrapper for Overheid.io
==================================

[](#simple-php-wrapper-for-overheidio)

This package provides a simple client for consuming the OverheidIo Api.

The API documentation can be found on: . You can get an api-key here

Installing OverheidIo
---------------------

[](#installing-overheidio)

The recommended way to install Overheid-Io is through [Composer](http://getcomposer.org).

```
composer require mstroink/overheid-io
```

After installing, you need to require Composer's autoloader:

```
require 'vendor/autoload.php';
```

Usage
-----

[](#usage)

```
use MStroink\OverheidIo\OverheidIoFactory;

$overheid = new OverheidIoFactory::create($apiKey);
```

Or use your own (authenticated) client. An adapter is required to be an implementation of \\MStroink\\OverheidIo\\Http\\HttpClientInterface

```
use MStroink\OverheidIo\OverheidIo;

$overheid = new OverheidIo($client);
```

### Rdw API

[](#rdw-api)

```
// Get car info by licence plate
try {
    $response = $overheid->rdw()->get('76-GP-LH');
} catch(\MStroink\OverheidIo\Exception\NotFoundException $e) {
    var_dump($e->getMessage());
    var_dump($e->getCode());
    var_dump($e->getPrevious());
}

// Search
$rdw = $overheid->rdw();
$response = $rdw
    ->fields(['merk', 'voertuigsoort', 'kenteken', 'eerste_kleur'])
    ->query('*laren')
    ->queryFields(['merk'])
    ->search();
```

### Bag API

[](#bag-api)

```
// Get bag info by bag id
try {
    $response = $overheid->bag()->get('3015ba-nieuwe-binnenweg-10-a');
} catch(\MStroink\OverheidIo\Exception\NotFoundException $e) {

}

// Search
$bag = $overheid->bag();
$response = $bag
    ->filters(['postcode' => '3015BA'])
    ->search();
```

### Kvk API

[](#kvk-api)

```
// Get company info by kvk id
try {
    $response = $overheid->kvk()->get('hoofdvestiging-57842019-0000-van-der-lei-techniek-bv');
} catch(\MStroink\OverheidIo\Exception\NotFoundException $e) {

}

// Search
$response = $overheid->kvk()
    ->filters(['dossiernummer' => '52921506'])
    ->search();

// Suggest
$response = $overheid->kvk()
    ->fields(['handelsnaam'])
    ->limit(10)
    ->suggest('Valken');
```

Filtering (All APIs)
--------------------

[](#filtering-all-apis)

```
$rdw = $overheid->rdw();

// Number of items returned in the response
$rdw->limit(100);

// Specify the page of results to return
$rdw->page(1);

// Control whether results are returned in ascending or descending order
$rdw->order('asc'); $rdw->order('desc');

// To limit the fields fetched, you can use the fields() method
$rdw->fields(['voertuigsoort', 'kenteken', 'merk', 'eerstekleur']);

//Filter results by value
$rdw->filters(['merk' => 'dikke-bmw']);

// Query for car brand ending with laren
$rdw->query('*laren');

// Apply this query on the merk field
$rdw->queryFields(['merk']);

// Execute
$rdw->search();
```

Run tests
---------

[](#run-tests)

```
vendor/bin/phpunit

```

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~211 days

Total

5

Last Release

1687d ago

PHP version history (3 changes)1.0.0PHP &gt;=7.1

v1.2.0PHP &gt;=7.2

v1.2.2PHP &gt;=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/48649879199862f81e23690807c3224ae4fbd7a99ad9f49d4fc8383482a5d0d3?d=identicon)[mstroink](/maintainers/mstroink)

---

Top Contributors

[![mstroink](https://avatars.githubusercontent.com/u/2270573?v=4)](https://github.com/mstroink "mstroink (11 commits)")

---

Tags

clientwrapperbagkvkrdwoverheid.io

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mstroink-overheid-io/health.svg)

```
[![Health](https://phpackages.com/badges/mstroink-overheid-io/health.svg)](https://phpackages.com/packages/mstroink-overheid-io)
```

###  Alternatives

[openai-php/client

OpenAI PHP is a supercharged PHP API client that allows you to interact with the Open AI API

5.8k22.6M232](/packages/openai-php-client)[algolia/algoliasearch-client-php

API powering the features of Algolia.

69433.0M114](/packages/algolia-algoliasearch-client-php)[codedredd/laravel-soap

A SoapClient wrapper integration for Laravel

221516.6k3](/packages/codedredd-laravel-soap)[mozex/anthropic-php

Anthropic PHP is a supercharged community-maintained PHP API client that allows you to interact with Anthropic API.

46365.1k13](/packages/mozex-anthropic-php)[swader/diffbot-php-client

A PHP wrapper for using Diffbot's API

5328.5k](/packages/swader-diffbot-php-client)[dhope0000/lxd

PHP-based API wrapper for LXD REST API.

136.2k](/packages/dhope0000-lxd)

PHPackages © 2026

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