PHPackages bastiaanh/overheid-kvk - 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. bastiaanh/overheid-kvk ActiveLibrary[API Development](/categories/api) bastiaanh/overheid-kvk ====================== Overheid.io KvK API Client for PHP v1.0.0(9y ago)47.7kMITPHPPHP >=5.3.0 Since Jul 23Pushed 9y ago1 watchersCompare [ Source](https://github.com/bastiaanh/overheid-kvk)[ Packagist](https://packagist.org/packages/bastiaanh/overheid-kvk)[ RSS](/packages/bastiaanh-overheid-kvk/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (2)Used By (0) Overheid.io KvK API client ========================== [](#overheidio-kvk-api-client) `overheid-kvk` provides a PHP wrapper class to use the [Overheid.io KvK API](https://overheid.io/documentatie). It automatically requests additional resources when needed, so you can simply use `foreach` to walk through large result sets. Installation using Composer --------------------------- [](#installation-using-composer) Add the dependency: ``` composer require bastiaanh/overheid-kvk ``` Known Limitations ----------------- [](#known-limitations) Currently the library does not validate parameters, so make sure you validate any user input first. Error messages returned by the webservice are also not detected. This should be improved. Usage ----- [](#usage) ### Setup [](#setup) Instantiate the class and set the API key you got from Overheid.io: ``` $kvk = new Overheid\Kvk(); $kvk->setApiKey('459a874e2f3...'); ``` ### Searching through the dataset [](#searching-through-the-dataset) Definition: ``` Overheid\Kvk::search([parameters : array = array()]):Overheid\Resultset ``` Example: Specify the parameters as described [here](https://overheid.io/documentatie/kvk#list) and loop through the results. ``` /** @var Overheid\Resultset $results */ $results = $kvk->search(array('filters' => array('postcode' => '3083cz'))); echo count($results) . ' results '; foreach ($results as $index => $result) { echo 'result ' . $index . ': '; var_dump($result); } ``` Result: ``` 30 results result 0: array (size=3) 'dossiernummer' => string '24156072' (length=8) 'handelsnaam' => string 'Haarzelf' (length=8) 'subdossiernummer' => string '0002' (length=4) result 1: array (size=3) 'dossiernummer' => string '24477501' (length=8) 'handelsnaam' => string 'Anroga' (length=6) 'subdossiernummer' => string '0000' (length=4) // ...more... result 28: array (size=3) 'dossiernummer' => string '28111270' (length=8) 'handelsnaam' => string 'Fiscoop Holding B.V.' (length=20) 'subdossiernummer' => string '0000' (length=4) result 29: array (size=3) 'dossiernummer' => string '28111275' (length=8) 'handelsnaam' => string 'Fiscoop Rotterdam-Zuid B.V.' (length=27) 'subdossiernummer' => string '0000' (length=4) ``` If more than 100 results are returned, the loop will request the additional records when needed. ### Getting details about a dossier number [](#getting-details-about-a-dossier-number) Definition: ``` Overheid\Kvk::get(dossierNr : string, [subDossierNr : string = '0000']):array ``` Example: ``` $details = $kvk->get('20106830'); var_dump($result); ``` Result: ``` array (size=15) 'actief' => boolean true 'bestaandehandelsnaam' => string 'Freshheads B.V.' (length=15) 'dossiernummer' => string '20106830' (length=8) 'handelsnaam' => string 'Freshheads B.V.' (length=15) 'handelsnaam_url' => string 'freshheads-bv' (length=13) 'huisnummer' => string '21' (length=2) 'huisnummertoevoeging' => string '' (length=0) 'plaats' => string 'Tilburg' (length=7) 'postcode' => string '5041EB' (length=6) 'statutairehandelsnaam' => string 'Freshheads B.V.' (length=15) 'straat' => string 'Wilhelminapark' (length=14) 'straat_url' => string 'wilhelminapark' (length=14) 'subdossiernummer' => string '0000' (length=4) 'type' => string 'Hoofdvestiging' (length=14) 'vestigingsnummer' => int 18389392 ``` ### Getting search term suggestions [](#getting-search-term-suggestions) Definition: ``` Overheid\Kvk::suggest(query : string, [size : int|null = null], [fields : array|null = null]):array ``` Example: ``` $result = $kvk->suggest('oudet', 5); var_dump($result); ``` Result: ``` array (size=2) 'handelsnaam' => array (size=5) 0 => array (size=2) 'text' => string 'Oude Tijdhof Optiek' (length=19) 'extra' => array (size=1) 'id' => string '62540661/0000' (length=13) 1 => array (size=2) 'text' => string 'Oude Tijdhof Optiek B.V.' (length=24) 'extra' => array (size=1) 'id' => string '05076440/0000' (length=13) 2 => array (size=2) 'text' => string 'Oude Tol Groenprojecten' (length=23) 'extra' => array (size=1) 'id' => string '22063560/0000' (length=13) 3 => array (size=2) 'text' => string 'Oude Toren Beheer B.V.' (length=22) 'extra' => array (size=1) 'id' => string '17073018/0000' (length=13) 4 => array (size=2) 'text' => string 'Oude Toren Consultancy' (length=22) 'extra' => array (size=1) 'id' => string '57244359/0000' (length=13) 'straat' => array (size=5) 0 => array (size=2) 'text' => string 'OUDE TELGTERWEG' (length=15) 'extra' => array (size=1) 'postcode' => string '3851EE' (length=6) 1 => array (size=2) 'text' => string 'Oude Telgterweg' (length=15) 'extra' => array (size=1) 'postcode' => string '3853PH' (length=6) 2 => array (size=2) 'text' => string 'Oude Trambaan' (length=13) 'extra' => array (size=1) 'postcode' => string '6093CE' (length=6) 3 => array (size=2) 'text' => string 'OUDE TRAMBAAN' (length=13) 'extra' => array (size=1) 'postcode' => string '2265DA' (length=6) 4 => array (size=2) 'text' => string 'OUDE TERBORGSEWEG' (length=17) 'extra' => array (size=1) 'postcode' => string '7004KA' (length=6) ``` ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity26 Limited adoption so far Community7 Small or concentrated contributor base Maturity58 Maturing project, gaining track record 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 Unknown Total 1 Last Release 3580d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/6ad999228946bd044bb55de4942b4160e73269e213d74038ab1e7a19eb5beab6?d=identicon)[bastiaanh](/maintainers/bastiaanh) --- Top Contributors [![bastiaanh](https://avatars.githubusercontent.com/u/19793231?v=4)](https://github.com/bastiaanh "bastiaanh (1 commits)") --- Tags apikvkoverheid.iooverheid ### Embed Badge ![Health badge](/badges/bastiaanh-overheid-kvk/health.svg) ``` [![Health](https://phpackages.com/badges/bastiaanh-overheid-kvk/health.svg)](https://phpackages.com/packages/bastiaanh-overheid-kvk) ``` ### Alternatives [m165437/laravel-blueprint-docs API Blueprint Renderer for Laravel 22779.0k](/packages/m165437-laravel-blueprint-docs) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)