Hoofdinhoud

Gebruikt u de COR API? Dan kunt u vanaf nu overstappen op API versie V2. Voor deze nieuwe versie krijgt u een nieuw endpoint en nieuwe API-sleutels. API versie V1 wordt uitgefaseerd. U heeft zes maanden de tijd om over te stappen zodat uw dienstverlening zonder onderbreking kan doorgaan.

Wat moet u doen?

  • Start zo snel mogelijk met de migratie naar API versie V2.
  • Gebruik het nieuwe endpoint.
  • Gebruik de nieuwe API-sleutels. De huidige sleutels werken niet met API versie V2.

Wilt u nieuwe API-sleutels ontvangen voor V2? Neem dan contact op met Logius via het aanvraagformulier.

Wat verandert er?

API versie V2 bevat verschillende technische verbeteringen:

  • betere datakwaliteit door gegevens uit de bron, met koppelingen naar de ROO en de KvK;
  • zoekacties op een specifiek OIN leveren alle informatie op. Andere zoekacties bevatten geen informatie van derde partijen;
  • gegevens zijn beschikbaar in JSON en HAL/JSON;
  • ondersteuning voor virtuele OIN's;
  • het responseobject is opgesplitst in een ROO-deel en een KvK-deel.

De mogelijkheid om te zoeken op KvK-nummer wordt eind september toegevoegd. Hierover volgt later aanvullende communicatie.

Waarom verandert dit?

Met API versie V2 wordt de COR API technisch verbeterd. Daarom wordt een nieuw endpoint beschikbaar gesteld en ontvangen afnemers nieuwe API-sleutels. De bestaande API versie wordt uitgefaseerd. Hiervoor geldt een overgangsperiode van zes maanden, zodat afnemers voldoende tijd hebben om over te stappen.

Meer informatie

Documentatie

https://oinregister.logius.nl/documenten

OpenAPI-specificaties

API V1: https://oinregister.logius.nl/api/v1/openapi.json

API V2: https://oinregister.logius.nl/api/v2/openapi.json

Virtueel OIN

Een Handelsregisternummer (HRN) is een virtueel nummer. Als er geen OIN beschikbaar is, leidt de TSP bij de aanvraag van een PKIoverheid-certificaat een identificerend nummer af uit het KvK-nummer. Dit HRN wordt niet opgenomen in een publiek raadpleegbare registratie. Via de COR API V2 kunt u opzoeken of een nummer een geregistreerd OIN of een HRN (virtueel OIN) is.

 

Gerelateerde dienst(en)

Centrale OIN Raadpleegvoorziening