Basisprofiel

Zoeken

Vestigingsprofiel

Naamgeving

Zoeken V1

Zoeken V2 API

Zoeken V1 API

Basisprofiel API

Vestigingsprofiel API

Naamgeving API

The release notes show the changes per release of the KVK Handelsregister Basisprofiel API. Read more below.

Wanneer er geen hoofdvestiging wordt gevonden tonen we een foutmelding. Deze was onjuist en is aangepast naar de juiste melding (IPD0007 -> IPD0005).

When no main branch is found, we show an error message. This was incorrect and has been changed to the correct message (IPD0007 -> IPD0005).

<p>De combinatie van foutbericht, IPD-code en HTTP-statuscode die je ontving was niet altijd correct. Dit is opgelost. Zie de <a href="/nl/documentation#status-codes">documentatie</a> voor mogelijke foutcodes.</p>

<p>The combination of error message, IPD code and HTTP status code you received was not always correct. This has been resolved. See the <a href="/documentation#status-codes">documentation</a> for possible error codes.</p>

Formele en materiële registratie datumvelden worden nu ook getoond in het hoofdvestiging blok.

Website wordt getoond in het eigenaar blok wanneer er geen vestigingen aanwezig zijn.

Lijst met handelsnamen worden nu ook getoond in de sub-resource hoofdvestiging.

Formal and material registration  date fields are now also shown in the main block.

Website is shown in the owner block if there are no branches.

List of trade names is now also shown in the sub-resource main block.

Voorheen werden de BAG-gegevens (geografische coördinaten) alleen getoond in de API KVK Handelsregister Vestigingsprofiel. Vanaf nu kun je de parameter <b>geoData</b> ook gebruiken in de API Basisprofiel. De gegevens zijn terug te zien in het hoofdniveau van de API, in de sub-resources <i>/eigenaar</i> en <i>/hoofdvestiging</i>. Als er geen hoofdvestiging is dan worden de adressen (bezoek- en correspondentieadres) van de rechtspersoon getoond in het Eigenaar-blok.

Previously, the BAG data (geographical coordinates) were only shown in the API KVK Handelsregister Vestigingsprofiel. From now on you can also use the <b>geoData</b> parameter in the API Basisprofiel. The data can be seen in the top level of the API, in the sub-resources <i>/eigenaar</i> and <i>/hoofdvestiging</i>. If there is no main branch, the addresses (visiting and correspondence addresses) of the legal entity are shown in the Owner block.

Het bezoek- en correspondentieadres wordt getoond onder het blok ‘Eigenaar’ wanneer er geen vestigingen aanwezig zijn. Als er wel vestigingen zijn, verandert de API niet. Het bezoek- en correspondentieadres van de ‘Hoofdvestiging’ wordt dan getoond.

Het blok ‘Adres’ is uitgebreid met ‘Toevoeging Adres’. Met dit veld wordt het adres nader geduid. Een voorbeeld is dat bij een bedrijfsverzamelgebouw meerdere vestigingen op hetzelfde adres kunnen zijn, waardoor er onderscheid gemaakt moet worden door een extra omschrijving van de locatie, bijvoorbeeld 3de verdieping kamer 315.

The visiting and postal addresses are shown under the header ‘Owner’ if there are no branches. If there are branches, the API does not change. The visiting and postal addresses of the ‘Main establishment’ will be displayed.

The field ‘Address addition’ has been added to the ‘Address’ block. This field gives extra information about the address. For example, there may be more than one branch at the same address in a communal building for businesses. An additional description of the location can help to differentiate these branches. For example: 3rd floor, room 315.

<p>Wanneer je niet-ondersteunde query parameters gebruikt in je API bevraging krijg je een foutmelding.</p><p>Bij de vorige versie werden ongeldige query parameters genegeerd. Mogelijk gebruikte je een ongeldige query parameter bij één van de KVK API’s. Je ontving dan een resultaat door het negeren van de ongeldige parameter, gebaseerd op de aanwezige geldige parameter(s). Dit wekte de suggestie dat een parameter was verwerkt, terwijl dat niet zo was. Dit kon onverwachte of verkeerde resultaten opleveren.</p><p>Met de aanpassing in de release van 1 november geven we in het geval een niet-ondersteunde query parameter is gebruikt HTTP-response code 400 (Bad Request) terug met de volgende foutmelding:</p><pre style="white-space: pre-wrap;" class="mb-4"><div>{</div><div class="ml-4">"meldingen": {</div><div class="ml-8">"fout": [</div><div class="ml-12">{</div><div class="ml-16">"code": "IPD1999",</div><div class="ml-16">"omschrijving": "De volgende opgegeven parameter(s) is (zijn) ongeldig: [lijst, van, ongeldige, queryParameters]"</div><div class="ml-12">}</div><div class="ml-8">]</div><div class="ml-4">}</div><div>}</div></pre><p class="mb-0">Check de ondersteunde queryparameters voor elke API in de swagger (OAS) files op de "Testen"-pagina via onze <a href="/nl/apis">API product pagina's</a>, of in de handleidingen op de <a href="/nl/support">Ondersteuning-pagina</a>.</p>

<p>If you use unsupported query parameters in your API query, you will get an error notification.</p><p>The previous version ignored invalid query parameters. You may have used an invalid query parameter in one of the KVK APIs. The result you got would have been based on the valid parameters that were present, wrongly suggesting that all parameters had been used. This would have led to unexpected or wrong results.</p><p>After the 1 November release, an unsupported query parameter will yield the HTTP response code 400 (Bad Request), with the following error notification:</p><pre style="white-space: pre-wrap;" class="mb-4"><div>{</div><div class="ml-4">"meldingen": {</div><div class="ml-8">"fout": [</div><div class="ml-12">{</div><div class="ml-16">"code": "IPD1999",</div><div class="ml-16">"omschrijving": "De volgende opgegeven parameter(s) is (zijn) ongeldig: [lijst, van, ongeldige, queryParameters]"</div><div class="ml-12">}</div><div class="ml-8">]</div><div class="ml-4">}</div><div>}</div></pre><p class="mb-0">Check the supported query parameters per API in the swagger (OAS) files on the Testing page, to be found via our <a href="/apis">API product pages</a>, or in the manuals on the <a href="/support">Support page</a>.</p>

De uitgebreide rechtsvorm wordt nu getoond. Bijvoorbeeld: bij een coöperatie zie je of er beperkte aansprakelijkheid (BA) is of wettelijke aansprakelijkheid (WA).

The extensive legal structure is now displayed. For example: if you look up a cooperative, you will see if there is limited liability (BA) or legal liability (WA).

Testing the APIs

Release Notes

Release notes KVK Handelsregister Basisprofiel

Release 1.4.4

Release 1.4.1

Release 1.4

Release 1.3

Release 1.2

Release 1.1.1

Release 1.1