KVK UBO-register uittreksel

Met de UBO-uittreksel API kun je op basis van een inschrijving (KVK-nummer) het actuele UBO-uittreksel van een organisatie opvragen. Het UBO-uittreksel laat zien of er voor de betreffende organisatie UBO’s geregistreerd staan.

Aansluiten

Voordat je deze API kunt gebruiken moet je een aantal zaken regelen.

Stap 1: Aansluiten API-abonnement.
Stap 2: Autorisatie aanvragen.
Stap 3: Certificaat uploaden.

Doorlooptijd

Hou er rekening mee dat het aanvraagproces enige tijd in beslag neemt. In verband met veiligheidscontroles kunnen we je niet direct aansluiten op de dag van aanvraag. 

Ook het toekennen van autorisaties gebeurt zorgvuldig en gecontroleerd. Om deze reden kunnen we niet alle organisaties tegelijkertijd toegang geven. We behandelen aanvragen op volgorde van binnenkomst. Wij adviseren banken daarom om de aanvraag tijdig te versturen.  

Veelgestelde vragen

Een UBO-uittreksel is een officieel document uit het UBO-register waarin staat wie de Ultimate Beneficial Owners (uiteindelijk belanghebbenden) van een organisatie zijn. De UBO is een natuurlijk persoon die uiteindelijke eigenaar is van een organisatie of feitelijke zeggenschap heeft over de organisatie.

Niet iedereen heeft toegang tot het UBO-register. 

  • UBO's kunnen hun eigen UBO-gegevens bekijken.
  • Organisaties die UBO’s hebben ingeschreven kunnen hun eigen UBO-registratie bekijken.
  • Sommige organisaties hebben toegang tot alle UBO-gegevens. Het verschilt per toegangsniveau welke gegevens een organisatie van een UBO mag bekijken. 

Het UBO register kent drie toegangsniveaus; UBOB1, UBOB2 en UBOB3. Op de website van KVK lees je meer over de drie toegangsniveaus. 

In het UBO-uittreksel vind je gegevens over: de maatschappelijke activiteit/onderneming, de UBO en het belang en meldingen. 

Bekijk alle gegevens in het UBO-register.

Het opvragen van het UBO-uittreksel kost € 3,10.

De UBO-uittreksel API werkt iets anders dan de andere API's. Het uittreksel wordt namelijk verstrekt in pdf-formaat. De pdf heeft een digitaal waarmerk. 

Je kunt het certificaat hergebruiken, als het voldoet aan de juiste eisen.

Standaard ontvang je alleen gegevens die horen bij het laagste autorisatieniveau (UBOB1). Wil je gegevens ophalen die passen bij jouw autorisatieniveau? Gebruik dan, wanneer je de order gaat aanmaken, de optie 'priveVolledig' en zet deze op 'true'.

De status 200 geeft aan dat de API het verzoek succesvol heeft verwerkt, maar niet of het pdf-bestand ook correct is verwerkt door je software. 

Chunked encoding

De PDF wordt als binaire data in de response teruggegeven. Daarbij kan gebruik worden gemaakt van chunked encoding. In plaats van de data in één pakket te versturen wordt het in delen verzonden. Mogelijk kan je software hier niet mee om gaan. Controleer daarom eerst of je software het bestand goed ontvangt en opslaat, voordat je het probeert te openen of converteren. 

UBO-uittreksel opvragen

Zodra de autorisatie is toegekend en het certificaat is geüpload, kun je het UBO-uittreksel opvragen.

1. Acces Token aanvragen

De eerste stap is het ophalen van een access token. Dit doe je met onderstaande endpoint.

De token stuur je mee in de Authorization header bij alle volgende API aanroepen. Daarnaast moet ook het client certificaat worden meegestuurd, dat wordt gebruikt voor het opzetten van de mTLS verbinding.

Endpoint

https://api-secure.kvk.nl/auth/oauth/v2/token

2. Aanmaken order

  • Gebruik onderstaand endpoint voor het aanmaken van een UBO-uittreksel order. 
  • Standaard ontvang je alleen gegevens die horen bij het laagste autorisatieniveau (UBOB1). Wil je gegevens ophalen die passen bij jouw autorisatieniveau? Gebruik dan de optie 'priveVolledig' en zet deze op 'true'. 
  • De order wordt asynchroon verwerkt, wat betekent dat de verwerking op de achtergrond gebeurt en je niet direct een eindresultaat ontvangt.

Endpoint

https://api-secure.kvk.nl/api/v1/order/uittreksels/ubo

3. Opvragen orderstatus

Met onderstaand endpoint kun je de status van je eerder aangemaakte order opvragen. Zodra de order is verwerkt, bevat de response een downloadlink naar het UBO-uittreksel.

Endpoint

https://api-secure.kvk.nl/api/v1/orders/status/{ordernummer}

4. Downloaden UBO-uittreksel in pdf-formaat

Het systeem biedt het UBO-uittreksel aan via een directe downloadlink. Deze downloadUrl kan verkregen worden door het opvragen van de orderstatus (endpoint in stap 3).

Endpoint

https://api-secure.kvk.nl/api/v1/vbu/uittreksels/{ordernummer}.pdf

OpenAPI Specificatie