KVK Handelsregister Functionarissen
Met de API Functionarissen kun je functionarisgegevens opvragen op basis van het KVK-nummer en in sommige gevallen ook het vestigingsnummer.
Abonnement aanvragen
Om gebruik te kunnen maken van deze API, moet je eerst een API abonnement aanvragen.
Functionarissen API bevragen
Er zijn drie manieren (endpoints) om de zes typen functionarissen en/of de eigenaar van een eenmanszaak op te vragen.
1. Alle functionarissen in één keer ophalen
Met alleen het KVK‑nummer kun je ervoor kiezen om alle functionaristypen en/of de eigenaar van een eenmanszaak in één keer op te vragen.
Endpoint
https://api.kvk.nl/api/v1/functionarissen/kvknummer/{kvkNummer}
2. Eén type functionaris opvragen
Je kunt ervoor kiezen om één specifiek type functionaris op te vragen via een subresource op basis van het KVK‑nummer. Je selecteert dan één van de zes functionaristypen of de eigenaar van een eenmanszaak. Bijvoorbeeld, de aansprakelijke.
Endpoint
https://api.kvk.nl/api/v1/functionarissen/kvknummer/{kvkNummer}/aansprakelijken
De meeste functionarissen staan geregistreerd bij het hele bedrijf (de onderneming). Gemachtigde functionarissen kunnen ook gekoppeld zijn aan een specifieke vestiging. Dat komt omdat een machtiging soms alleen geldt voor één of meer vestigingen.
Wil je weten wie gemachtigd is voor een bepaalde vestiging? Dan zoek je met KVK-nummer én vestigingsnummer. Je krijgt dan alleen de gemachtigde personen van die specifieke vestiging terug.
Endpoint
https://api.kvk.nl/api/v1/functionarissen/kvknummer/{kvkNummer}/vestigingsnummer/{vestigingsnummer}
3. Meerdere typen functionarissen opvragen
Je kunt ook meerdere functionaristypen tegelijk opvragen door parameters mee te geven aan het einde van de URL na het KVK‑nummer. Hiermee maak je een selectie uit de zes functionaristypen en/of de eigenaar van een eenmanszaak. Bijvoorbeeld, overige functies en bestuursfuncties.
Endpoint
https://api.kvk.nl/api/v1/organisatie/kvknummer/{kvknummer}/aansprakelijken
Niet-openbare en/of afgeschermde gegevens opvragen
Standaard worden openbare en niet-afgeschermde gegevens geleverd. Wil je toegang tot niet-openbare gegevens? Dan moet je extra handelingen uitvoeren.
Lees meer over niet-openbare gegevens opvragen
Swagger UI
Test de API met Swagger UI. Deze toont de functies en mogelijkheden, hoe je toegang krijgt en hoe je de API gebruikt. Ontdek op een interactieve en visuele manier hoe je de API het beste kunt inzetten voor jouw project.
Input
| Parameter | Details |
|---|---|
| kvkNummer | Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer. Nummer dat bestaat uit 8 cijfers. |
| Type | Filter op type. Mogelijke waarden zijn: maatschappelijke-activiteit, onderneming, persoon, vestigingen. |
| geoData | Voeg geodata toe aan het response. Geodata wordt in de output getoond wanneer de waarde “true” is. Default waarde is “false”. |
Output
Veelgestelde vragen over de Functionarissen API
- Vaststellen wie tekenbevoegd is.
- Controleren wie bevoegd is tot vertegenwoordiging.
- Verifiëren van volmachten en eventuele beperkingen.
- Inzien wie curator, bewindvoerder of rechter‑commissaris is bij een bijzondere rechtstoestand.
Een functionaris is een persoon die een functie vervult binnen een onderneming of rechtspersoon. Het woord ‘functionaris’ wordt gebruikt als overkoepelend begrip voor een onderverdeling naar soort functionaris. Elke functionaris wordt onderverdeeld naar één specifieke soort.
Bekijk een overzicht van alle soorten functionarissen met bijbehorende rollen
Functionarissen worden in het Handelsregister ingeschreven onder de Maatschappelijke Activiteit. Aan iedere Maatschappelijke Activiteit is een rechtsvorm gekoppeld. Op basis van die rechtsvorm kun je bepaalde typen functionarissen verwachten.
Bekijk een overzicht van alle soorten functionarissen per rechtsvorm
Het dataveld soortFunctionaris geeft aan of de functionaris een NatuurlijkePersoon, NietNatuurlijkePersoon, NaamPersoon of een AnonniemePersoon is. Afhankelijk van de soortFunctionaris worden de gegevens van de functionaris ingevuld onder persoonlijkeGegevens. Bij de anonieme persoon worden geen persoonlijke gegevens geregistreerd.
Een NaamPersoon is een functionaris waarvan uitsluitend de /naamFunctionaris, naam en telefoonnummer (optioneel) wordt geregistreerd. Een naamPersoon is alleen van toepassing bij een curator, rechter-commissaris en bewindvoerder (bijzondereRechtstoestandFunctie).
Een AnoniemePersoon is een functionaris waarvan geen persoonlijke gegevens worden geregistreerd. Van deze functionaris wordt uitsluitend een titel geregistreerd. Dit komt bijvoorbeeld voor bij privaatrechtelijk gevolmachtigde functionarissen.
Afhankelijk van de soortFunctionaris, ontvang je een specifiek type Adres. Wanneer de functionaris een NatuurlijkePersoon is, wordt het woonadres van deze functionaris getoond. Dit woonadres is een niet-openbaar gegeven en is alleen zichtbaar wanneer je over de juiste autorisatie beschikt.
Wanneer de functionaris een NietNatuurlijkePersoon is, wordt het bezoekadres weergeven. In het geval van een concrete dreiging kan dit bezoekadres worden afgeschermd. Een afgeschermd bezoekadres is eveneens alleen zichtbaar met de juiste autorisatie.
Wanneer de functionaris een NaamPersoon is, wordt het Adres van deze functionaris getoond.
Een schorsing van een functionaris is alleen mogelijk voor de volgende rollen:
- Bestuurder
- Persoon krachtens statuten bevoegd bij ontstentenis/belet van de bestuurder(s)
- Vertegenwoordiger van de bestuurder/rechtspersoon
- Lid toezichthoudend orgaan
- Lid E.E.S.V.
- Commissaris
- Gemachtigde (Gevolmachtigde)
- Publiekrechtelijk bestuurder
- Publiekrechtelijk lid toezichthoudend orgaan
- Publiekrechtelijke commissaris
De API Functionarissen toont altijd de actuele gegevens. Wanneer je de API aanroept met een actief KVK nummer, ontvang je de functionarissen die op het moment van bevragen staan ingeschreven. Het is ook mogelijk om een KVK nummer op te vragen dat inmiddels is uitgeschreven. In dat geval ontvang je de laatst bekende stand: de functionarissen die op het moment van beëindiging waren ingeschreven.
Het is mogelijk om zogeheten grote (XL) dossiers op te vragen (denk aan ABN-AMRO, Rabobank). Let wel op dat de response tijd van zo’n bevraging aanzienlijk hoger ligt dan wat je van ons gewend bent. Dit komt door de grote hoeveelheden regels aan data die teruggestuurd worden. Dit kan mogelijk leiden tot time-outs.
Het is niet mogelijk om de API Functionarissen in combinatie met KMS (KVK Mutatie Service) te gebruiken. De API Functionarissen is gebaseerd op Gegevenscatalogus 4.0 en levert data vanuit het DataLeveringsPlatform (DLP). KMS daarentegen is nog aangesloten op de Gegevenscatalogus 3.0.4. en baseert zijn signalen op wijzigingen in de Productstore.
Omdat beide producten op een andere databron zijn aangesloten, kan de rechtszekerheid van de signalen en de bijbehorende wijzigingen niet worden gegarandeerd. Daarom raden wij sterk af om op basis van een KMS-signaal de API Functionarissen te bevragen. Gebruik de API Functionarissen als een zelfstandig product.
De organisatiegegevens (van rechtspersonen) zijn op zichzelf geen persoonsgegevens. Maar de API kan informatie bevatten die naar een persoon te herleiden is. In dat geval zijn het wel persoonsgegevens en gelden de privacyregels.
Sinds 25 mei 2018 geldt in de hele Europese Unie de Algemene Verordening Gegevensbescherming (AVG). Deze wet geldt voor alle organisaties die persoonsgegevens gebruiken of opslaan.
Gebruik je de API Organisatie? Lees dan eerst goed de informatie van de Autoriteit Persoonsgegevens. Controleer ook of je voldoet aan belangrijke regels, zoals:
- je gebruikt gegevens alleen voor een duidelijk doel (doelbinding);
- je verzamelt niet meer gegevens dan nodig is (dataminimalisatie).
Heb je vragen of loop je tegen problemen aan? Vul dan het contactformulier in.
- Kies als onderwerp "API bevragingen".
- Vul je naam en e-mailadres in.
- Noteer bij het veld "API bevraging" dat het om de Pre-release API Functionarissen gaat en beschrijf je vraag of probleem.
- Verstuur het formulier.
Enkele weken na ingebruikname van de API plannen we een evaluatiegesprek in, om te kijken hoe de API bevalt. Tijdens dit gesprek komen onderstaande punten/ vragen aan bod.
- Wanneer je de huidige versie van de API Functionarissen gebruikt; wat is er verbeterd of verslechterd? Heb je tips?
- Hoe gemakkelijk was het koppelen van deze API?
- Hoe heb je het aanvraagproces ervaren, het instellen van de Access Token en het aanvragen van certificaten?
- Hoe gebruik je deze API? Welk endpoint, welke datavelden, mis je functionarisgegevens?
- Wat vind je van de documentatie? Mis je informatie?
- Wat vind je van de veelgestelde vragen? Mis je informatie?
- Heb je nog andere tips of adviezen?