KVK Handelsregister Organisatie
Met de API Organisatie kun je actuele gegevens opvragen van organisaties, op basis van een KVK-nummer.
Abonnement aanvragen
Om gebruik te kunnen maken van deze API, moet je eerst een API abonnement aanvragen.
Organisatie API bevragen
Er zijn verschillende manieren om de gegevens uit API Organisatie op te vragen.
1. Alle beschikbare onderdelen van een organisatie opvragen
Endpoint
https://api.kvk.nl/api/v1/organisatie/kvknummer/{kvknummer}
2. Een specifiek onderdeel opvragen
Beschikbare onderdelen zijn: maatschappelijke activiteit, onderneming, persoon en vestigingen.
Endpoint
https://api.kvk.nl/api/v1/organisatie/kvknummer/{kvknummer}/onderneming
3. Meerdere specifieke onderdelen opvragen
Bijvoorbeeld maatschappelijke activiteit en onderneming.
Endpoint
https://api.kvk.nl/api/v1/organisatie/kvknummer/{kvknummer}?type=maatschappelijke-activiteit&type=onderneming
Geodata
Wil je Geodata ontvangen, wanneer deze aanwezig zijn? Voeg dan een extra stukje code toe aan het endpoint.
Endpoint
https://api.kvk.nl/api/v1/organisatie/kvknummer/{kvknummer}?geoData=true
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
Algemeen
Algemene informatie over het KVK-nummer waarmee de API Organisatie is aangeroepen.
| Parameter | Details | Openbaar |
|---|---|---|
| kvkNummer | Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer. Nummer dat bestaat uit 8 cijfers. | Ja |
| actief | Indicator die aangeeft of de inschrijving actief of inactief is. | Ja |
MaatschappelijkeActiviteit
Een maatschappelijke activiteit is de verzameling van ondernemingen (artikel 9 Handelsregisterwet 2007) en activiteiten van rechtspersonen waaraan geen onderneming toebehoort (artikel 13 Handelsregisterwet 2007).
| Parameter | Details | Openbaar |
|---|---|---|
| datumAanvang | De datum waarop de activiteiten van een onderneming of rechtspersoon start of gestart is. | Ja |
| datumEinde | De datum waarop de activiteiten van een onderneming of rechtspersoon gestopt is. | Ja |
| registratieTijdstip Inschrijving | De datum en het tijdstip van de eerste inschrijving in het Handelsregister van de onderneming en/of rechtspersoon. | Ja |
| registratieTijdstipUitschrijving | De datum en het tijdstip van de uitschrijving uit het Handelsregister van de onderneming en/of rechtspersoon. | Ja |
| onterechteInschrijving | Deze indicatie geeft aan of de inschrijving is doorgehaald vanwege dubbele inschrijving of onterechte inschrijving in geval van een onderneming die nooit is gestart. | Ja |
uitzonderingDerdenwerking
| Indicatie die aangeeft dat de rechtspersoon ambtshalve is ingeschreven en er nog geen opgave met handtekening is ontvangen. In dat geval is er géén sprake van derdenwerking. Na registratie van een opgave met handtekening vervalt deze uitzondering. | Ja |
| incidenteelUitlenenArbeidskrachten | Indicatie die aangeeft dat de onderneming of rechtspersoon tijdelijk arbeidskrachten ter beschikking stelt en dit niet onderdeel is van zijn 'reguliere' activiteiten. | Ja |
| rechtsvorm | De rechtsvorm van de inschrijving. | Ja |
| uitgebreideRechtsvorm | De rechtsvorm (conform Burgerlijk Wetboek Boek 2) van de inschrijving aangevuld met informatie over structuur, rechtsbevoegdheid etc. | Ja |
| VoortzettingOnderneming | Zie tabel VoortzettingOnderneming. | |
| Naamgevingen | De verzameling van ontdubbelde namen van alle niet-commerciële vestigingen.
De volgorde van deze namen is bij opgave bepaald.
Deze lijst bevat alleen de namen.
Zie tabel Naamgevingen | |
| Activiteiten | De verzameling van alle ontdubbelde activiteiten van alle niet-commerciële vestigingen van de maatschappelijke activiteit of de activiteiten van de rechtspersoon.
Er kunnen meerdere hoofdactiviteiten zijn, namelijk voor één voor elke vestiging.
Zie tabel Activiteiten. |
|
VoortzettingOnderneming
De onderneming is voortgezet in een andere maatschappelijke activiteit.
| Parameter | Details | Openbaar |
|---|---|---|
| datumVoortzettingOnderneming | De datum waarop de voortzetting onderneming heeft plaatsgevonden. | Ja |
| registratieTijdstip VoortzettingOnderneming | Het tijdstip waarop de VoortzettingOnderneming bij de KVK in het Handelsregister is geregistreerd. | Ja |
Onderneming
Een onderneming is een aan het economisch verkeer deelnemende zelfstandige organisatorische eenheid van voldoende arbeid en/of middelen die tegen vergoeding goederen en/of diensten levert aan derden dan wel werken tot stand brengt met het oogmerk daarmee materieel voordeel te behalen.
| Parameter | Details | Openbaar |
|---|---|---|
| datumAanvang | De datum waarop de activiteiten van de onderneming starten of gestart zijn. | Ja |
| datumEinde | De datum waarop de activiteiten van de onderneming gestopt zijn. | Ja |
| registratieTijdstip Inschrijving | De datum en het tijdstip van de (eerste) inschrijving in het Handelsregister. | Ja |
| registratieTijdstipUitschrijving | De datum en het tijdstip van de uitschrijving uit het Handelsregister. | Ja |
| ambtshalveUitschrijving | Indicatie die aangeeft of de onderneming ambtshalve is opgeheven. | Ja |
| totaalWerkzame Personen | Het totaal aantal werkzame personen van de onderneming is de optelsom van het aantal parttime en fulltime werkzame personen van alle commerciële vestigingen. | Ja |
| parttimeWerkzamePersonen | Het totaal aantal parttime werkzame personen van de onderneming is de optelsom van het aantal parttime werkzame personen van alle commerciële vestigingen. | Ja |
| fulltimeWerkzamePersonen | Het totaal aantal fulltime werkzame personen van de onderneming is de optelsom van het aantal fulltime werkzame personen van alle commerciële vestigingen. | Ja |
| Naamgevingen | De verzameling van ontdubbelde handelsnamen van alle commerciële vestigingen.
De volgorde van deze handelsnamen is bij opgave bepaald.
Deze lijst bevat alleen de Handelsnamen.
Zie tabel Naamgevingen. | |
| Activiteiten | De verzameling van ontdubbelde activiteiten van alle commerciële vestigingen van de onderneming.
Er kunnen meerdere hoofdactiviteiten zijn, namelijk één voor elke vestiging.
Zie tabel Activiteiten. | |
| Onderneming Gestaakt | Zie tabel OndernemingGestaakt. |
OndernemingGestaakt
De gegevens van een onderneming die eerder beëindigd is dan de rechtspersoon. Dit komt voor in de volgende situaties:
- De onderneming wordt overgedragen naar een andere maatschappelijke activiteit en de rechtspersoon wordt op een later moment beëindigd.
- De onderneming en de rechtspersoon worden beide op een ander moment in de tijd opgeheven.
| Parameter | Details | Openbaar |
|---|---|---|
| datumEinde | De datum waarop de activiteiten van de onderneming gestopt zijn. | Ja |
| registratieTijdstipUitschrijving | De datum en het tijdstip van de uitschrijving van de onderneming uit het Handelsregister. | Ja |
| ambtshalveUitschrijving | Indicatie die aangeeft of de onderneming ambtshalve is opgeheven. | Ja |
Persoon
- Een Persoon is een drager van rechten en plichten en kan rechtshandelingen verrichten.
- Persoon wordt gebruikt als overkoepelend begrip voor de verzameling van NatuurlijkePersoon en NietNatuurlijkePersoon.
- Een Persoon is de eigenaar van een Maatschappelijke Activiteit.
| Parameter | Details | Openbaar |
|---|---|---|
| BijzondereRechtstoestand | Zie tabel BijzondereRechtstoestand. | |
| NietNatuurlijkePersoon | Zie tabel NietNatuurlijkePersoon. |
BijzondereRechtstoestand
- Een bijzondere rechtstoestand is een insolventie of beperking in rechtshandeling.
- Een bijzondere rechtstoestand is altijd het gevolg van een rechterlijke uitspraak en heeft betrekking op een natuurlijke persoon of niet natuurlijke persoon.
| Parameter | Details | Openbaar |
|---|---|---|
| Insolventie | Zie tabel Insolventie. | |
| BeperkingInRechtshandeling | Zie tabel BeperkingInRechtshandeling. |
Insolventie
Voor de persoon is een insolventie aanwezig. Onder insolventie vallen de volgende drie situaties: faillissement, surseance van betaling en schuldsanering.
| Parameter | Details | Openbaar |
|---|---|---|
| datumAanvang | De datum waarop de bijzondere rechtstoestand is ontstaan. | Ja |
| datumEinde | De datum waarop de bijzondere rechtstoestand is beëindigd. | Ja |
| registratieTijdstipBijzondereRechtstoestand | Het tijdstip waarop de inschrijving van de bijzondere rechtstoestand bij de KVK in het Handelsregister is geregistreerd. | Ja |
| datumUitspraak | De datum waarop de uitspraak door de rechter is gedaan. | Ja |
| naamGerecht | De rechtbank waar de uitspraak heeft plaatsgevonden. | Ja |
| plaatsGerecht | De plaats van rechtbank waar de uitspraak heeft plaatsgevonden. | Ja |
| soort | Het soort bijzondere rechtstoestand. In het Handelsregister kunnen de volgende drie soorten worden geregistreerd:
| Ja |
| redenEinde | Geeft de reden van het einde van de insolventie. | Ja |
| status | De status waarin de surseance van betaling of schuldsanering verkeert, dit kan voorlopig of definitief zijn. | Ja |
BeperkingInRechtshandeling
Voor de persoon is een beperking in rechtshandeling aanwezig. Onder beperking in rechtshandeling vallen de volgende drie situaties: onder curatele gesteld, onder bewind gesteld en provisioneel bewind.
| Parameter | Details | Openbaar |
|---|---|---|
| datumAanvang | De datum waarop de bijzondere rechtstoestand is ontstaan. | Ja |
| datumEinde | De datum waarop de bijzondere rechtstoestand is beëindigd. | Ja |
| registratieTijdstipBijzondereRechtstoestand | Het tijdstip waarop de inschrijving van de bijzondere rechtstoestand bij de KVK in het Handelsregister is geregistreerd. | Ja |
| datumUitspraak | De datum waarop de uitspraak door de rechter is gedaan. | Ja |
| naamGerecht | De rechtbank waar de uitspraak heeft plaatsgevonden. | Ja |
| plaatsGerecht | De plaats van rechtbank waar de uitspraak heeft plaatsgevonden. | Ja |
| soort | Soort beperking in rechtshandeling. In het Handelsregister kunnen de volgende drie soorten worden geregistreerd:
| Ja |
NietNatuurlijkePersoon
Een niet natuurlijke persoon is een persoon met rechten en plichten die geen natuurlijke persoon is.
| Parameter | Details | Openbaar |
|---|---|---|
| rsin | Een door de KVK aan een rechtspersoon, personenvennootschap of rederij toegekend uniek nummer. | Ja |
| datumAanvang | De datum waarop de niet natuurlijke persoon is opgericht. | Ja |
| datumEinde | De datum waarop de niet natuurlijke persoon is beëindigd. | Ja |
| registratieTijdstip Inschrijving | De datum en het tijdstip waarop de inschrijving van de niet natuurlijke persoon in het Handelsregister is geregistreerd. | Ja |
| registratieTijdstipUitschrijving | De datum en het tijdstip van de registratie van beëindiging in óf uitschrijving van de niet natuurlijke persoon uit het Handelsregister. | Ja |
| specificatieRechtsvorm | Een nadere aanduiding van de rechtsvorm van de publiekrechtelijke rechtspersoon, overige privaatrechtelijke rechtspersoon en buitenlandse persoon. | Ja |
| datumAkteOprichting | De datum waarop de akte van oprichting is gepasseerd bij de notaris. | Ja |
| statutaireZetel | De plaats of gemeente waar de niet natuurlijke persoon volgens zijn statuten zijn zetel heeft. | Ja |
| datumAanvang LaatsteStatuten wijziging | De datum waarop de (laatste) statutenwijziging is ingegaan. | Ja |
| datumAkteLaatsteStatutenwijziging | De datum waarop de akte, waarin de (laatste) statutenwijziging is opgenomen, is gepasseerd bij de notaris. | Ja |
| datumUitschrijving | De datum dat de niet natuurlijke persoon is uitgeschreven.
Voor bepaalde niet natuurlijke personen (buitenlandse niet natuurlijke personen en verenigingen met beperkte rechtsbevoegdheid) geldt dat deze kunnen worden uitgeschreven, terwijl zij verder blijven voortbestaan. In dat geval wordt niet de datum einde, maar de datum uitschrijving gebruikt | Ja |
| Naamgevingen | De verzameling van ontdubbelde namen van alle niet-commerciële vestigingen.
De volgorde van deze namen is bij opgave bepaald.
Deze lijst bevat alleen de namen.
Zie tabel Naamgevingen. | |
| Communicatie gegevens | Zie tabel Communicatiegegevens. | |
| Adres | Zie tabel Adres. | |
| PersonenvennootschapGegevens | Zie tabel PersonenvennootschapGegevens. | |
| Rechtspersoon Gegevens | Zie tabel RechtspersoonGegevens. | |
| Buitenlandse PersoonGegevens | Zie tabel BuitenlandsePersoonGegevens. | |
| OmzettingRechtsvorm | Zie tabel OmzettingRechtsvorm. | |
| Ontbinding | Zie tabel Ontbinding. | |
| BuitenlandseRechtstoestand | Zie tabel BuitenlandseRechtstoestand. |
Communicatiegegevens
De communicatiegegevens van de niet natuurlijke persoon. Communicatiegegevens zijn optioneel en daarom niet altijd aanwezig. Ook kan er sprake zijn van meerdere communicatiegegevens.
| Parameter | Details | Openbaar |
|---|---|---|
| soortCommunicatieGegeven | Bevat de waarden telefoonnummer, emailadres (in geval van een e-mailadres) of internetadres (in geval van een website. | Ja/Nee |
| internetadres | Het internetadres (WWW) waarop de rechtspersoon via internet bereikbaar is. | Ja |
| telefoonnummer | Het telefoonnummer waarop de rechtspersoon bereikbaar is. | Nee |
| emailadres | Het e-mailadres waarop de rechtspersoon per e-mail bereikbaar is. | Ja |
Adres
Een Adres geeft een locatie aan welke kan worden bezocht of waarnaar post kan worden verzonden.
| Parameter | Details | Openbaar |
|---|---|---|
| Bezoekadres | Zie tabel Bezoekadres. | |
| Postadres | Zie tabel Postadres. |
Bezoekadres
Het Adres van een niet natuurlijke persoon waarop deze fysiek bereikbaar is.
| Parameter | Details | Openbaar |
|---|---|---|
| bezoekadresAfgeschermd | Geeft aan of het bezoekadres, op basis van een afschermingsverzoek, afgeschermd is of niet. | Ja |
| soortAdres | Geeft aan welk soort adres het betreft. Het adres kan één van de volgende soorten zijn:
| Ja/Nee |
| straatnaam | De straat van het adres. | Ja/Nee |
| straatnaamHuisnummer | Een combinatie van de straatnaam en het huisnummer in het buitenland. | Ja/Nee |
| aanduidingBijBinnenlandsAdres | De aanduiding die wordt gebruikt voor adressen die niet zijn voorzien van de gebruikelijke straatnaam en huisnummeraanduidingen. Mogelijke waarden zijn: bij, tegenover. | Ja/Nee |
| huisnummer | Het huisnummer van het adres. | Ja/Nee |
| huisletter | De huisletter die door de gemeente is toegekend aan het huisnummer. | Ja/Nee |
| huisnummerToevoeging | Een toevoeging van het adres bijvoorbeeld rood, bis, etc. | Ja/Nee |
| postcode | De in Nederland gangbare postcode voor een Nederlands postadres, bestaande uit een numeriek deel en een alfabetisch deel. | Ja/Nee |
| postcodePlaats | De combinatie van een postcode en plaats in het buitenland. | Ja/Nee |
| woonplaats | De woonplaats van het adres betreft een door het bevoegde gemeentelijke orgaan als zodanig aangewezen en van een naam voorzien gedeelte van het grondgebied van de gemeente. | Ja/Nee |
| regio | Regio is een deel van het land (streek, provincie, etc.). | Ja/Nee |
| Land | Het land waar het adres zich bevindt. | Ja/Nee |
| identificatieAdresseerbaarObject | De unieke BAG identificatie van een adresseerbaar object. Een adresseerbaar object is een verblijfsobject, een standplaats of een ligplaats. | Ja/Nee |
| identificatieNummeraanduiding | De unieke identificatie van de BAG nummeraanduiding. Een nummeraanduiding is een door het bevoegde gemeentelijke orgaan als zodanig toegekende aanduiding van een verblijfsobject, een standplaats of een ligplaats. | Ja/Nee |
| toevoegingAdres | Vrije tekst om een Adres nader aan te kunnen duiden. Het gaat hier bijvoorbeeld om bedrijfsverzamelgebouwen waarbij meerdere vestigingen op hetzelfde adres zitten en waarbij onderscheid gemaakt worden door een extra omschrijving van de locatie, bijvoorbeeld 3de verdieping kamer 315. | Ja/Nee |
| locatiebeschrijving | Vrije tekst wanneer er sprake is van een vrije locatie. | Ja/Nee |
| geoData | Zie tabel GeoData. |
Postadres
Het adres van een niet natuurlijke persoon voor correspondentie.
| Parameter | Details | Openbaar |
|---|---|---|
| soortAdres | Geeft aan welk soort adres het betreft. Het adres kan één van de volgende soorten zijn:
| Ja |
| straatnaam | De straat van het adres. | Ja |
| straatnaamHuisnummer | Een combinatie van de straatnaam en het huisnummer in het buitenland. | Ja |
| aanduidingBijBinnenlandsAdres | De aanduiding die wordt gebruikt voor adressen die niet zijn voorzien van de gebruikelijke straatnaam en huisnummeraanduidingen. Mogelijke waarden zijn: bij, tegenover. | Ja |
| huisnummer | Het huisnummer van het adres. | Ja |
| huisletter | De huisletter die door de gemeente is toegekend aan het huisnummer. | Ja |
| huisnummerToevoeging | Een toevoeging van het adres bijvoorbeeld rood, bis, etc. | Ja |
| postbusnummer | Het nummer van een postbus dat wordt gebruikt als postadres. | Ja |
| postcode | De in Nederland gangbare postcode voor een Nederlands postadres, bestaande uit een numeriek deel en een alfabetisch deel. | Ja |
| postcodePlaats | De combinatie van een postcode en plaats in het buitenland. | Ja |
| woonplaats | De woonplaats van het adres betreft een door het bevoegde gemeentelijke orgaan als zodanig aangewezen en van een naam voorzien gedeelte van het grondgebied van de gemeente. | Ja |
| regio | Regio is een deel van het land (streek, provincie, etc.). | Ja |
| land | Het land waar het adres zich bevindt. | Ja |
| identificatieAdresseerbaarObject | De unieke BAG identificatie van een adresseerbaar object. Een adresseerbaar object is een verblijfsobject, een standplaats of een ligplaats. | Ja |
| identificatieNummeraanduiding | De unieke identificatie van de BAG nummeraanduiding. Een nummeraanduiding is een door het bevoegde gemeentelijke orgaan als zodanig toegekende aanduiding van een verblijfsobject, een standplaats of een ligplaats. | Ja |
| toevoegingAdres | Vrije tekst om een Adres nader aan te kunnen duiden. Het gaat hier bijvoorbeeld om bedrijfsverzamelgebouwen waarbij meerdere vestigingen op hetzelfde adres zitten en waarbij onderscheid gemaakt worden door een extra omschrijving van de locatie, bijvoorbeeld 3de verdieping kamer 315. | Ja |
| locatiebeschrijving | Vrije tekst wanneer er sprake is van een vrije locatie. | Ja |
| GeoData | Zie tabel GeoData. |
GeoData
Basisregistratie Adressen en Gebouwen gegevens uit het kadaster.
| Parameter | Details | Openbaar |
|---|---|---|
| gpsLatitude | GPS Breedtegraad. | Ja/Nee |
| gpsLongitude | GPS Lengtegraad. | Ja/Nee |
| rijksdriehoekX | Rijksdriehoek X-coördinaat. | Ja/Nee |
| rijksdriehoekY | Rijksdriehoek Y-coördinaat. | Ja/Nee |
| rijksdriehoekZ | Rijksdriehoek Z-coördinaat. | Ja/Nee |
PersonenvennootschapGegevens
Het betreft de personen vennootschaps gegevens van een niet natuurlijke persoon.
Een personenvennootschap is een rechtsvorm zonder rechtspersoonlijkheid die wordt gevormd op basis van een overeenkomst tussen twee of meer personen met als doel een onderneming uit te oefenen.
| Parameter | Details | Openbaar |
|---|---|---|
| aantalCommanditaireVennoten | Het aantal commanditaire vennoten.
| Ja |
| heeftOnbepaaldeDuur | Indicatie die aangeeft of de duur waarvoor de personenvennootschap is aangegaan voor onbepaalde tijd is. | Ja |
| eindeDuur | De datum waarop de periode waarvoor de overeenkomst van de personenvennootschap is aangegaan eindigt. Dit gegeven wordt niet gevuld als de overeenkomst voor onbepaalde tijd is. | Ja |
| CommanditairKapitaal | Zie tabel CommanditairKapitaal. |
CommanditairKapitaal
Het geldbedrag en de waarde van de goederen die een of meer commanditaire vennoten aan de commanditaire vennootschap ter beschikking hebben gesteld of overeengekomen zijn ter beschikking te zullen stellen.
| Parameter | Details | Openbaar |
|---|---|---|
| soort | Geeft aan of het commanditaire kapitaal in geld of goederen ter beschikking wordt gesteld. | Ja |
| bedrag | De waarde van het commanditair kapitaal in valuta. | Ja |
RechtspersoonGegevens
- Het betreft de rechtspersoon gegevens van een niet natuurlijke persoon.
- Een rechtspersoon is een zelfstandig drager van rechten en plichten, niet zijnde een natuurlijke persoon.
| Parameter | Details | Openbaar |
|---|---|---|
| activiteitenomschrijving | De activiteitenomschrijving is een korte omschrijving van de feitelijk uitgeoefende activiteiten van de rechtspersoon. | Ja |
| beleggingsMijMetVeranderlijkKapitaal | Indicatie die aangeeft of de vennootschap een beleggingsmaatschappij is met veranderlijk kapitaal. | Ja |
| geplaatstKapitaal | De totale nominale waarde van alle aandelen die de kapitaalvennootschap heeft uitgegeven. De nominale waarde is het in de statuten van de kapitaalvennootschap vermelde bedrag waarvoor een aandeel oorspronkelijk is uitgegeven. | Ja |
| gestortKapitaal | De som van die gedeelten van de nominale waarde van de aandelen die daadwerkelijk door de aandeelhouders aan de kapitaalvennootschap is voldaan. | Ja |
| maatschappelijkKapitaal | Het maximale bedrag, vermeld in de statuten, waarvoor door de kapitaalvennootschap aandelen mogen worden uitgegeven. | Ja |
| rechtsbevoegdheidVereniging | Geeft aan of het een vereniging met een volledige of beperkte rechtsbevoegdheid is. | Ja |
| stelselInrichting | De inrichting van een rechtspersoon waarbij het bestuur en het toezicht op het bestuur in één orgaan zijn ondergebracht (monistisch) of waarbij het bestuur en het toezicht op het bestuur in twee afzonderlijke organen zijn ondergebracht (dualistisch). | Ja |
| structuur | Geeft aan of de rechtspersoon een gewone of bijzondere structuur heeft. | Ja |
| meerdereSoortenAandelen | Indicatie die aangeeft of er verschillende soort aandelen zijn. | Ja |
| datumVoornemenOntbindingDoorKVK | De datum waarop het voornemen van de ontbinding bij de KVK in het Handelsregister is geregistreerd | Ja |
| RegistratieTijdstipVoornemenOntbindingDoorKVK | Het tijdstip waarop het voornemen van de ontbinding in het Handelsregister is geregistreerd. | Ja |
| Activiteiten | De verzameling van alle activiteiten van een rechtspersoon.
Een rechtspersoon heeft altijd maar één hoofdactiviteit.
Zie tabel Activiteiten. |
BuitenlandsePersoonGegevens
- De buitenlandse persoon gegevens van een niet natuurlijke persoon.
- Een buitenlandse persoon is een persoon die is opgericht naar buitenlands recht.
| Parameter | Details | Openbaar |
|---|---|---|
| datumEerste InschrijvingBuiten land | De datum waarop de buitenlandse persoon is ontstaan. | Ja |
| datumFormeel BuitenlandsSinds | De datum waarop de buitenlandse persoon als formeel buitenlandse persoon is aangemerkt. | Ja |
| landVanOprichting | Het land waarin de BuitenlandsePersoon is opgericht | Ja |
geplaatstKapitaal
| Het geplaatste kapitaal is de totale nominale waarde van alle aandelen die de kapitaalvennootschap heeft uitgegeven. De nominale waarde is het in de statuten van de kapitaalvennootschap vermelde bedrag waarvoor een aandeel oorspronkelijk is uitgegeven. | Ja |
| BuitenlandseRegistratie | Zie tabel BuitenlandseRegistratie. |
Buitenlandse Registratie
De registratie van de buitenlandse persoon in het buitenlands register en de gegevens van dat register.
| Parameter | Details | Openbaar gegeven |
|---|---|---|
| buitenlandseRegistratie | De combinatie van attributen over de inschrijving in het buitenlandse register. | Ja |
| naamBuitenlandsRegister | De naam waaronder het buitenlandse register naar buiten treedt. | Ja |
| plaatsBuitenlandsRegister | De plaats waar het buitenlandse register wordt gehouden. | Ja |
| landBuitenlandsRegister | Het land waar het buitenlandse register wordt gehouden. | Ja |
| inschrijfnummer | Het registratienummer in het buitenlands register voor ondernemingen is het nummer waaronder de buitenlandse persoon in het buitenlands register is geregistreerd. | Ja |
OmzettingRechtsvorm
Er is sprake van een omzetting rechtsvorm voor de niet natuurlijke persoon.
| Parameter | Details | Openbaar |
|---|---|---|
| datumOmzetting Rechtsvorm | De datum dat de omzetting van de rechtsvorm heeft plaatsgevonden. | Ja |
| registratieTijdstipOmzettingRechtsvorm | Het tijdstip waarop het registratietijdstip omzetting rechtsvorm bij de KVK in het Handelsregister is geregistreerd | Ja |
Ontbinding
Voor de niet natuurlijke persoon is er sprake van een ontbinding. De ontbinding is het proces waarbij de personenvennootschap of rechtspersoon wordt beëindigd en eventueel aanwezig vermogen moet worden vereffend.
| Parameter | Details | Openbaar |
|---|---|---|
| datumOntbinding | De datum waarop de personenvennootschap of rechtspersoon is ontbonden. | Ja |
| registratieTijdstipOntbinding | Het tijdstip waarop de inschrijving van de ontbinding in het Handelsregister is geregistreerd. | Ja |
| redenOntbinding | Nadere specificatie wat de aanleiding voor de ontbinding is geweest. | Ja |
| datumAanvang Liquidatie | De datum waarop de liquidatie van de rechtspersoon of personenvennootschap is begonnen. | Ja |
| datumEindeLiquidatie | De datum waarop bij de vereffenaar geen baten meer bekend zijn en de vennootschap of rechtspersoon ophoudt te bestaan. | Ja |
| datumHeropeningLiquidatie | De datum waarop de liquidatie van de personenvennootschap of rechtspersoon heropend is. | Ja |
BuitenlandseRechtstoestand
- Er is voor de niet natuurlijke persoon een buitenlandse rechtstoestand aanwezig.
- Een buitenlandse rechtstoestand is een gerechtelijke uitspraak door een buitenlands gerecht. De inhoud van de uitspraak is niet van te voren gedefinieerd. De inhoud van de uitspraak is door de kamermedewerker vrij in te vullen.
| Parameter | Details | Openbaar |
|---|---|---|
| beschrijving | De beschrijving van de buitenlandse uitspraak. | Ja |
Vestigingenlijst
Een lijst van alle vestigingen die activiteiten uitoefenen onder de maatschappelijke activiteit.
| Parameter | Details | Openbaar |
|---|---|---|
| Vestigingsnummer | Betreft het identificerende gegeven van de Vestiging. Uniek nummer dat bestaat uit 12 cijfers. | Ja |
| soortVestiging | Geeft aan of deze vestiging een hoofdvestiging of nevenvestiging is. | Ja |
Naamgevingen
| Parameter | Details | Openbaar |
|---|---|---|
| naam | De naam die hoort bij de onderneming, niet natuurlijke persoon, commerciële of niet-commerciële vestiging. | Ja |
| soortNaam | Geeft het soort naam aan:
| Ja |
Activiteiten
Activiteiten bevat de SBI-code met bijbehorende omschrijving van die activiteit.
| Parameter | Type | Details | Openbaar |
|---|---|---|---|
| sbiCode | String | De SBI-code is een code (van maximaal 6 cijfers) voor de classificatie van activiteiten.
De codering van de activiteit is conform de SBI classificatie bij CBS. | Ja |
| soortActiviteit | String | Geeft aan of een Activiteit een hoofdactiviteit of nevenactiviteit is. | Ja |
Veelgestelde vragen over de Organisatie API
De API Organisatie bevat gegevens over:
- Maatschappelijke activiteit
- Onderneming
- Niet natuurlijke persoon
- Lijst met vestigingen
Je kunt de API Organisatie onder andere gebruiken om alle handelsnamen van een organisatie op te vragen, inzicht te krijgen in de activiteiten die een organisatie uitvoert, te achterhalen via welke communicatiegegevens een organisatie bereikbaar is en te controleren of de organisatie in een bijzondere rechtstoestand verkeert.
De API levert een set gegevens in REST JSON-formaat, zodat je deze direct kunt verwerken in je eigen systemen.
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 Organisatie gaat en beschrijf je vraag of probleem.
- Verstuur het formulier.
We nemen zo snel mogelijk contact met je op.
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.
Gebruik van API Organisatie als alternatief voor API Basisprofiel
- Wanneer je afnemer bent van API Basisprofiel: hoe ervaar je API Organisatie als vervanging?
- Welke functionaliteiten of gegevens mis je in API Organisatie?
- Zijn er aspecten die juist verbeterd zijn ten opzichte van API Basisprofiel?
Aansluitproces en onboarding
- Hoe heb je het aansluitproces (autorisaties en certificaten) ervaren?
- Hoe eenvoudig was het om de API te koppelen en werkend te krijgen?
- Waar liep je eventueel tegenaan tijdens de implementatie?
Gebruik van de API in de praktijk
- Hoe gebruik je de API momenteel?
- In welke processen heb je de API geïmplementeerd?
- Welke endpoints en datavelden zet je in?
- Mis je bepaalde gegevens of functionaliteiten die voor jouw gebruikssituatie waardevol zouden zijn?
Documentatie
- Was de documentatie volledig en duidelijk genoeg om met de API te werken?
- Welke informatie ontbreekt of kan beter worden toegelicht?
- Mist er informatie in de FAQ die voor jou relevant zou zijn?
Gebruikerservaring
- Hoe ervaar je de API in dagelijks gebruik (performance, stabiliteit, consistentie)?
- Zijn er verbeterpunten in de gebruiksvriendelijkheid of betrouwbaarheid?
- Overige tips of adviezen?