API Kvk Zoeken

Informatie over het response model is te vinden in de Swagger API

Info

Kvk zoeken /v1 is vanaf 29 juli 2024 End Of Life (EOL) en kan dan niet meer gebruikt worden.

Zoeken op hoofdvestiging

• GET /v2/chamber-of-commerce/search/{chamberOfCommerceNumber}
• Input: Kamer van Koophandel nummer
• Type: hoofdvestiging

Zoeken op nevenvestiging

• GET /v2/chamber-of-commerce/search/{chamberOfCommerceNumber}
• Input: Kamer van Koophandel nummer
• Type: nevenvestiging

Zoeken op Rechtspersoon

• GET /v2/chamber-of-commerce/basic-profile/branches/{chamberOfCommerceNumber}
• Input: Kamer van Koophandel nummer
• Type: rechtspersoon

Zoeken op alles

• GET /v2/chamber-of-commerce/basic-profile/owner/{chamberOfCommerceNumber}
• Input: Kamer van Koophandel nummer
• Type: leeg (deze optie is niet te testen via Swagger, wel via postman)

Response

Ongeldig Kvk

Als een Kvk nummer niet gevonden kan worden of ongeldig is verschijnt deze output:

{
    "fout": [
        {
            "code": "IPD0004",
            "omschrijving": "Het KVK-nummer 569979 is niet valide."
        }
    ]
}

Response error

Als er een andere fout optreedt:

{
  "fout": [
    {
      "code": "IPD5200",
      "omschrijving": "Er zijn geen gegevens gevonden die voldoen aan de opgegeven zoekparameters."
    }
  ]
}

Foutcodes

API key ongeldig

Neem contact op met de Niaros Business Support afdeling.

{
  "fout": [
    {
      "code": null,
      "omschrijving": "IL-Foutmelding\nFoutcode      : APIKEY01\nFoutmelding   : Invalid API Key : XXXXXXXXXXX \nFoutcomponent : KVK Handelsregister zoeken API V.1\nTransactie-ID : XXXXXXXXXXXXXXX"
    }
  ]
}