Release notes KVK Handelsregister Zoeken

De combinatie van foutbericht, IPD-code en HTTP-statuscode die je ontving was niet altijd correct. Dit is opgelost. Zie de documentatie voor mogelijke foutcodes.

Vanaf 10 december wordt standaard in het zoekresultaat alleen nog de actieve vestigingen en rechtspersonen teruggegeven. Dit zorgt ervoor dat er minder zoekresultaten dan voorheen worden weergegeven, hetgeen in veel situaties efficiënter werkt.

Om ook inactieve vestigingen en rechtspersonen terug te krijgen in het zoekresultaat is er een nieuwe parameter toegevoegd, ‘inclusiefinactieveregistraties’. Bij het gebruik van deze parameter zal er in het zoekresultaat ook een indicatie zijn of de desbetreffende vestiging of rechtspersoon actief of inactief is. Indien de gevonden vestiging of rechtspersoon niet actief is en is uitgeschreven voor 22 mei 2010, dan zal er geen link aanwezig zijn naar de API KVK Handelsregister Basisprofiel en KVK Handelsregister Vestigingsprofiel.

Wanneer je niet-ondersteunde query parameters gebruikt in je API bevraging krijg je een foutmelding.

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.

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:

{
"meldingen": {
"fout": [
{
"code": "IPD1999",
"omschrijving": "De volgende opgegeven parameter(s) is (zijn) ongeldig: [lijst, van, ongeldige, queryParameters]"
}
]
}
}

Check de ondersteunde queryparameters voor elke API in de swagger (OAS) files op de "Testen"-pagina via onze API product pagina's, of in de handleidingen op de Ondersteuning-pagina.