openapi: 3.0.1 info: title: Organisatie API description: Opvragen van een organisatie termsOfService: https://www.kvk.nl/over-het-handelsregister/gebruikersvoorwaarden-handelsregistergegevens/ contact: name: Kamer van Koophandel url: https://developers.kvk.nl/nl version: '1.0' servers: - url: https://api.preprod.kvk.nl/api description: PreProd API - url: https://api.kvk.nl/api description: Productie API (alleen te gebruiken met een API key voor het opvragen van openbare data) - url: https://api-secure.kvk.nl/api description: Productie API (te gebruiken met een certificaat voor het opvragen van afgeschermde data) security: - ApiKeyAuth: [] - BearerAuth: [] tags: - name: organisatie externalDocs: description: Voor meer informatie over deze API url: https://developers.kvk.nl/nl/support paths: /v1/organisatie/kvknummer/{kvkNummer}: get: tags: - organisatie summary: Opvragen van een organisatie op basis van een kvkNummer operationId: organisatie parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '12345678' required: true schema: pattern: ^[0-9]{8}$ type: string - name: type in: query description: Filter op type schema: type: array items: type: string enum: - maatschappelijke-activiteit - onderneming - persoon - vestigingen - name: geoData in: query description: Voeg geodata toe aan het response schema: type: boolean required: false example: geoData=true responses: '200': description: Het verzoek levert een resultaat op. Als geen resultaten worden gevonden die aan de path parameter voldoen, wordt een 404 NotFound teruggegeven headers: api-version: $ref: '#/components/headers/api_version' warning: $ref: '#/components/headers/warning' content: application/json: schema: $ref: '#/components/schemas/OrganisatieDto' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '406': $ref: '#/components/responses/NotAcceptable' '500': $ref: '#/components/responses/InternalServerError' default: $ref: '#/components/responses/DefaultError' /v1/organisatie/kvknummer/{kvkNummer}/maatschappelijke-activiteit: get: tags: - maatschappelijke-activiteit summary: Maatschappelijke activiteit opvragen op basis van een kvkNummer operationId: maatschappelijkeActiviteit parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '12345678' required: true schema: pattern: ^[0-9]{8}$ type: string responses: '200': description: Het verzoek levert een resultaat op. Als geen resultaten worden gevonden die aan de path parameter voldoen, wordt een 404 NotFound teruggegeven headers: api-version: $ref: '#/components/headers/api_version' warning: $ref: '#/components/headers/warning' content: application/json: schema: $ref: '#/components/schemas/MaatschappelijkeActiviteitDto' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '406': $ref: '#/components/responses/NotAcceptable' '500': $ref: '#/components/responses/InternalServerError' default: $ref: '#/components/responses/DefaultError' /v1/organisatie/kvknummer/{kvkNummer}/onderneming: get: tags: - onderneming summary: Onderneming opvragen op basis van een kvkNummer operationId: onderneming parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '12345678' required: true schema: pattern: ^[0-9]{8}$ type: string responses: '200': description: Het verzoek levert een resultaat op. Als geen resultaten worden gevonden die aan de path parameter voldoen, wordt een 404 NotFound teruggegeven headers: api-version: $ref: '#/components/headers/api_version' warning: $ref: '#/components/headers/warning' content: application/json: schema: $ref: '#/components/schemas/OndernemingDto' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '406': $ref: '#/components/responses/NotAcceptable' '500': $ref: '#/components/responses/InternalServerError' default: $ref: '#/components/responses/DefaultError' /v1/organisatie/kvknummer/{kvkNummer}/persoon: get: tags: - persoon summary: Persoon opvragen op basis van een kvkNummer operationId: persoon parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '12345678' required: true schema: pattern: ^[0-9]{8}$ type: string - name: geoData in: query description: Voeg geodata toe aan het response schema: type: boolean required: false example: geoData=true responses: '200': description: Het verzoek levert een resultaat op. Als geen resultaten worden gevonden die aan de path parameter voldoen, wordt een 404 NotFound teruggegeven headers: api-version: $ref: '#/components/headers/api_version' warning: $ref: '#/components/headers/warning' content: application/json: schema: $ref: '#/components/schemas/PersoonDto' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '406': $ref: '#/components/responses/NotAcceptable' '500': $ref: '#/components/responses/InternalServerError' default: $ref: '#/components/responses/DefaultError' /v1/organisatie/kvknummer/{kvkNummer}/vestigingen: get: tags: - vestigingen summary: Vestigingen opvragen op basis van een kvkNummer operationId: vestigingen parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '12345678' required: true schema: pattern: ^[0-9]{8}$ type: string responses: '200': description: Het verzoek levert een resultaat op. Als geen resultaten worden gevonden die aan de path parameter voldoen, wordt een 404 NotFound teruggegeven headers: api-version: $ref: '#/components/headers/api_version' warning: $ref: '#/components/headers/warning' content: application/json: schema: $ref: '#/components/schemas/VestigingenDto' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '406': $ref: '#/components/responses/NotAcceptable' '500': $ref: '#/components/responses/InternalServerError' default: $ref: '#/components/responses/DefaultError' components: securitySchemes: BearerAuth: type: http description: De JWT token dient bij elk request meegestuurd te worden. Indien deze niet juist wordt meegestuurd, of het een ongeldig token betreft, zul je de foutmelding `401 Unauthorized` terugkrijgen scheme: bearer bearerFormat: JWT ApiKeyAuth: type: apiKey description: De API-key die je hebt gekregen dient bij elke request via de `apikey` request header meegestuurd te worden. Indien deze niet juist wordt meegestuurd, of het een ongeldige key betreft, zul je de foutmelding `401 Unauthorized` terugkrijgen name: apikey in: header schemas: OrganisatieDto: x-implements: - Organisatie type: object required: - kvkNummer properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' maatschappelijkeActiviteit: properties: links: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore' allOf: - $ref: '#/components/schemas/LinksDto' gegevens: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonUnwrapped' allOf: - $ref: '#/components/schemas/MaatschappelijkeActiviteitGegevensDto' onderneming: properties: links: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore' allOf: - $ref: '#/components/schemas/LinksDto' gegevens: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonUnwrapped' allOf: - $ref: '#/components/schemas/OndernemingGegevensDto' persoon: properties: links: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore' allOf: - $ref: '#/components/schemas/LinksDto' gegevens: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonUnwrapped' allOf: - $ref: '#/components/schemas/PersoonGegevensDto' vestigingen: properties: links: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore' allOf: - $ref: '#/components/schemas/LinksDto' gegevens: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonUnwrapped' allOf: - $ref: '#/components/schemas/ItemsDto' Fout: type: object properties: code: description: Foutcode type: string omschrijving: description: Omschrijving van de foutmelding type: string Error: type: object properties: fout: type: array items: $ref: '#/components/schemas/Fout' IndicatieDto: description: Geeft de indicatie aan van de bewering die met het attribuut wordt omschreven; J (Ja) N (Nee) O (Onbekend) type: object properties: code: type: string enum: - J - 'N' - O omschrijving: type: string AlgemeenDto: type: object x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonUnwrapped' properties: kvkNummer: description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' type: string pattern: ^[0-9]{8}$ actief: description: Indicator die aangeeft of de inschrijving actief of inactief is allOf: - $ref: '#/components/schemas/IndicatieDto' LinksDto: type: object required: - href properties: href: type: string title: type: string SoortRegistratieTijdstipDto: description: Geeft het soort naam van het registratietijdstip aan; DATUMTIJDSTIP (DatumTijdstip), VASTGESTELD_ONBEKEND (Vastgesteld onbekend) type: object properties: code: type: string enum: - DATUMTIJDSTIP - VASTGESTELD_ONBEKEND omschrijving: type: string RegistratieTijdstipDto: type: object properties: soortRegistratieTijdstip: $ref: '#/components/schemas/SoortRegistratieTijdstipDto' waarde: type: string pattern: ^[0-9]{17}$ RechtsvormDto: type: object properties: code: type: string enum: - BV - EMZmME - BPart24 - RED - BPart25 - MA - NV - RPIO - COP - BPart26 - VOF - CV - KG - VvE - OWM - ST - EESV - SE - VER - OPR - SCE - PR - EMZ omschrijving: type: string VoortzettingOndernemingDto: description: De onderneming is voortgezet in een andere MaatschappelijkeActiviteit type: array items: properties: datumVoortzettingOnderneming: description: De datum waarop de VoortzettingOnderneming heeft plaatsgevonden type: string pattern: ^[0-9]{8}$ registratieTijdstipVoortzettingOnderneming: description: Het tijdstip waarop de VoortzettingOnderneming bij de KvK in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstipDto' SoortNaamDto: description: Geeft het soort naam aan; Handelsnaam (Handelsnaam), Naam (Naam), OokGenoemd (OokGenoemd), StatutaireNaam (StatutaireNaam) type: object properties: code: type: string enum: - Handelsnaam - Naam - OokGenoemd - StatutaireNaam omschrijving: type: string NaamgevingenDto: type: array items: properties: naam: description: De naam die hoort bij de Onderneming, NietNatuurlijkePersoon, Commerciële of Niet-Commerciële vestiging type: string maxLength: 625 soortNaam: $ref: '#/components/schemas/SoortNaamDto' SbiCodeDto: description: 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 type: object properties: code: type: string omschrijving: type: string SoortActiviteitDto: description: Geeft aan of een Activiteit een hoofdactiviteit of nevenactiviteit is; Hoofdactiviteit (Hoofdactiviteit), Nevenactiviteit (Nevenactiviteit) type: object properties: code: type: string enum: - Hoofdactiviteit - Nevenactiviteit omschrijving: type: string ActiviteitenDto: type: array items: properties: sbiCode: $ref: '#/components/schemas/SbiCodeDto' soortActiviteit: $ref: '#/components/schemas/SoortActiviteitDto' MaatschappelijkeActiviteitGegevensDto: description: Een MaatschappelijkeActiviteit is de verzameling van ondernemingen (artikel 9 Handelsregisterwet 2007) en activiteiten van rechtspersonen waaraan geen onderneming toebehoort (artikel 13 Handelsregisterwet 2007) type: object properties: datumAanvang: description: De datum waarop de activiteiten van een onderneming of rechtspersoon start of gestart is type: string pattern: ^[0-9]{8}$ datumEinde: description: De datum waarop de activiteiten van een onderneming of rechtspersoon gestopt is type: string pattern: ^[0-9]{8}$ registratieTijdstipInschrijving: description: De datum en het tijdstip van de eerste inschrijving in het Handelsregister van de onderneming en/of rechtspersoon allOf: - $ref: '#/components/schemas/RegistratieTijdstipDto' registratieTijdstipUitschrijving: description: De datum en het tijdstip van de uitschrijving uit het Handelsregister van de onderneming en/of rechtspersoon allOf: - $ref: '#/components/schemas/RegistratieTijdstipDto' onterechteInschrijving: description: Deze indicatie geeft aan of de inschrijving is doorgehaald vanwege dubbele inschrijving of onterechte inschrijving in geval van een onderneming die nooit is gestart allOf: - $ref: '#/components/schemas/IndicatieDto' uitzonderingDerdenwerking: description: 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 allOf: - $ref: '#/components/schemas/IndicatieDto' incidenteelUitlenenArbeidskrachten: description: Indicatie die aangeeft dat de onderneming of rechtspersoon tijdelijk arbeidskrachten ter beschikking stelt en dit niet onderdeel is van zijn 'reguliere' activiteiten allOf: - $ref: '#/components/schemas/IndicatieDto' rechtsvorm: description: De rechtsvorm van de inschrijving; BV (Besloten Vennootschap), EMZmME (Eenmanszaak met meerdere eigenaren), BPart24 (Kapitaalvennootschap binnen EER), RED (Rederij), BPart25 (Kapitaalvennootschap buiten EER), MA (Maatschap), NV (Naamloze Vennootschap), RPIO (Rechtspersoon in oprichting), COP (Coöperatie), BPart26 (Overige buitenlandse rechtspersoon of vennootschap), VOF (Vennootschap Onder Firma), CV (Commanditaire Vennootschap), KG (Kerkgenootschap), VvE (Vereniging van Eigenaars), OWM (Onderlinge Waarborg Maatschappij), ST (Stichting), EESV (Europees economisch samenwerkingsverband), SE (Europese naamloze vennootschap), VER (Vereniging), OPR (Overige Privaatrechtelijke Rechtspersoon), SCE (Europese coöperatieve vennootschap), PR (Publiekrechtelijke Rechtspersoon), EMZ (Eenmanszaak) allOf: - $ref: '#/components/schemas/RechtsvormDto' uitgebreideRechtsvorm: description: De rechtsvorm (conform Burgerlijk Wetboek Boek 2) van de inschrijving aangevuld met informatie over structuur, rechtsbevoegdheid etc. type: string maxLength: 500 voortzettingOnderneming: $ref: '#/components/schemas/VoortzettingOndernemingDto' naamgevingen: description: 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 allOf: - $ref: '#/components/schemas/NaamgevingenDto' activiteiten: description: De verzameling van alle ontdubbelde activiteiten van alle niet-commerciële vestigingen van de MaatschappelijkeActiviteit of de activiteiten van de Rechtspersoon. Er kunnen meerdere hoofdactiviteiten zijn, namelijk één voor elke Vestiging. Activiteit bevat de SBI-code met bijbehorende omschrijving van die activiteit allOf: - $ref: '#/components/schemas/ActiviteitenDto' OndernemingGestaaktDto: description: 'De gegevens van een Onderneming die eerder beëindigd is dan de rechtspersoon, zie RechtspersoonGegevens. 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' type: object properties: datumEinde: description: De datum waarop de activiteiten van de onderneming gestopt zijn type: string pattern: ^[0-9]{8}$ registratieTijdstipUitschrijving: description: De datum en het tijdstip van de uitschrijving van de Onderneming uit het Handelsregister allOf: - $ref: '#/components/schemas/RegistratieTijdstipDto' ambtshalveUitschrijving: description: 'Indicatie die aangeeft of de onderneming ambtshalve is opgeheven. Mogelijke waarden: Dit gegeven heeft de waarde ‘Ja’ of ‘Nee’' allOf: - $ref: '#/components/schemas/IndicatieDto' OndernemingGegevensDto: description: 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 type: object properties: datumAanvang: description: De datum waarop de activiteiten van de onderneming starten of gestart zijn type: string pattern: ^[0-9]{8}$ datumEinde: description: De datum waarop de activiteiten van de onderneming gestopt zijn type: string pattern: ^[0-9]{8}$ registratieTijdstipInschrijving: description: De datum en het tijdstip van de (eerste) inschrijving in het Handelsregister allOf: - $ref: '#/components/schemas/RegistratieTijdstipDto' registratieTijdstipUitschrijving: description: De datum en het tijdstip van de uitschrijving uit het Handelsregister allOf: - $ref: '#/components/schemas/RegistratieTijdstipDto' ambtshalveUitschrijving: description: 'Indicatie die aangeeft of de onderneming ambtshalve is opgeheven. Mogelijke waarden: Dit gegeven heeft de waarde ‘Ja’ of ‘Nee’' allOf: - $ref: '#/components/schemas/IndicatieDto' totaalWerkzamePersonen: description: Het totaal aantal werkzame personen van de onderneming is de optelsom van het aantal parttime en fulltime werkzame personen van alle commerciële vestigingen type: integer parttimeWerkzamePersonen: description: Het totaal aantal parttime werkzame personen van de onderneming is de optelsom van het aantal parttime werkzame personen van alle commerciële vestigingen type: integer fulltimeWerkzamePersonen: description: Het totaal aantal fulltime werkzame personen van de onderneming is de optelsom van het aantal fulltime werkzame personen van alle commerciële vestigingen type: integer naamgevingen: description: De verzameling van ontdubbelde handelsnamen van alle commerciële vestigingen. De volgorde van deze handelsnamen is bij opgave bepaald. Deze lijst bevaten alleen de Handelsnamen allOf: - $ref: '#/components/schemas/NaamgevingenDto' activiteiten: description: De verzameling van ontdubbelde activiteiten van alle commerciële vestigingen van de Onderneming. Er kunnen meerdere hoofdactiviteiten zijn, namelijk één voor elke Vestiging. Activiteit bevat de SBI-code met bijbehorende omschrijving van die activiteit allOf: - $ref: '#/components/schemas/ActiviteitenDto' ondernemingGestaakt: $ref: '#/components/schemas/OndernemingGestaaktDto' BijzondereRechtstoestandGegevensDto: properties: datumAanvang: description: De datum waarop de BijzondereRechtstoestand is ontstaan type: string pattern: ^[0-9]{8}$ datumEinde: description: De datum waarop de BijzondereRechtstoestand is beëindigd type: string pattern: ^[0-9]{8}$ registratieTijdstipBijzondereRechtstoestand: description: Het tijdstip waarop de inschrijving van de BijzondereRechtstoestand bij de KvK in het handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstipDto' datumUitspraak: description: De datum waarop de uitspraak door de rechter is gedaan type: string pattern: ^[0-9]{8}$ naamGerecht: description: De rechtbank waar de uitspraak heeft plaatsgevonden type: string maxLength: 500 plaatsGerecht: description: De plaats van rechtbank waar de uitspraak heeft plaatsgevonden type: string maxLength: 80 InsolventieSoortDto: description: Het soort bijzondere rechtstoestand; FAIL (Faillissement), SSAN (Schuldsanering), SURS (Surseance van betaling) type: object properties: code: type: string enum: - FAIL - SSAN - SURS omschrijving: type: string InsolventieRedenEindeDto: description: Geeft de reden van de einde van de insolventie; AF (Aanvang faillissement), HA (Homologatie van het akkoord), RU (Rechterlijke uitspraak), VS (Verbindend worden van de slot-/enige uitdelingslijst), RV (Intrekking bij rechterlijk vonnis), AS (Aanvang schuldsanering), VT (Verloop van de termijn(en)), VH (Vernietiging na hoger beroep), VC (Vernietiging na cassatie), WB (Opheffing wegens toestand van de boedel/gebrek aan baten), NV (Vernietiging na gedaan verzet), VV (Volledige betaling van de vorderingen), ZU (Zonder uitdeling en zonder schone lei) type: object properties: code: type: string enum: - AF - HA - RU - VS - RV - AS - VT - VH - VC - WB - NV - VV - ZU omschrijving: type: string InsolventieStatusDto: description: De status waarin de surseance van betaling of schuldsanering verkeert; 001 (Voorlopig), 002 (Definitief) type: object properties: code: type: string enum: - '001' - '002' omschrijving: type: string InsolventieDto: description: 'Voor de Persoon is en Insolventie aanwezig. Onder insolventie vallen de volgende drie situataties: faillissement, surseance van betaling en schuldsanering' type: object allOf: - $ref: '#/components/schemas/BijzondereRechtstoestandGegevensDto' properties: soort: $ref: '#/components/schemas/InsolventieSoortDto' redenEinde: $ref: '#/components/schemas/InsolventieRedenEindeDto' status: $ref: '#/components/schemas/InsolventieStatusDto' BeperkingInRechtshandelingSoortDto: description: Soort beperking in rechtshandeling; Provisioneel (Provisioneel bewind), Curatele (Onder curatele gesteld), Bewind (Onder bewind gesteld) type: object properties: code: type: string enum: - Provisioneel - Curatele - Bewind omschrijving: type: string BeperkingInRechtshandelingDto: description: 'Voor de Persoon is een BeperkingInRechtshandeling aanwezig. Onder beperking in rechtshandeling vallen de volgende drie situaties: onder curatele gesteld, onder bewind gesteld en provisioneel bewind' type: object allOf: - $ref: '#/components/schemas/BijzondereRechtstoestandGegevensDto' properties: soort: $ref: '#/components/schemas/BeperkingInRechtshandelingSoortDto' BijzondereRechtstoestandDto: description: Een bijzondere rechtstoestand is een Insolventie of BeperkingInRechtshandeling. Een bijzondere rechtstoestand is altijd het gevolg van een rechterlijke uitspraak en heeft betrekking op een NatuurlijkePersoon of NietNatuurlijkePersoon type: object properties: insolventie: $ref: '#/components/schemas/InsolventieDto' beperkingInRechtshandeling: $ref: '#/components/schemas/BeperkingInRechtshandelingDto' SoortNaamPersoonDto: description: Geeft het soort naam van de NietNatuurlijkePersoon aan; Handelsnaam (Handelsnaam), Naam (Naam), OokGenoemd (OokGenoemd), StatutaireNaam (StatutaireNaam) type: object properties: code: type: string enum: - Handelsnaam - Naam - OokGenoemd - StatutaireNaam omschrijving: type: string NaamgevingenPersoonDto: type: array items: properties: naam: description: De naam die hoort bij de Onderneming, NietNatuurlijkePersoon, Commerciële of Niet-Commerciële vestiging type: string maxLength: 625 soortNaam: $ref: '#/components/schemas/SoortNaamPersoonDto' SoortCommunicatiegegevenDto: type: object description: Bevat de waarden Telefoonnummer, Emailadres (in geval van een e-mailadres) of Internetadres (in geval van een website); T (Telefoonnummer), E (Emailadres), I (Internetadres) properties: code: type: string enum: - T - E - I omschrijving: type: string TelefoonnummerDto: description: Het telefoonnummer waarop de Rechtspersoon bereikbaar is type: object properties: landnummer: description: De internationale toegangscode van het land dat hoort bij het telefoonnummer type: string maxLength: 5 nummer: description: Het telefoonnummer zonder opmaak. Zowel het netnummer als het abonneenummer maken deel uit van dit nummer, zonder internationale toegangscode type: string maxLength: 15 CommunicatiegegevensDto: description: De communicatiegegevens van de NietNatuurlijkePersoon. Er kan sprake zijn van meerdere communicatiegegevens type: array items: properties: soortCommunicatiegegeven: $ref: '#/components/schemas/SoortCommunicatiegegevenDto' internetadres: description: Het internetadres (WWW) waarop de Rechtspersoon via internet bereikbaar is type: string maxLength: 300 telefoonnummer: $ref: '#/components/schemas/TelefoonnummerDto' emailadres: description: Het e-mailadres waarop de Rechtspersoon per e-mail bereikbaar is type: string maxLength: 200 SoortAdresDto: description: Geeft aan welk soort adres het betreft. Het adres kan één van de volgende soorten zijn; BinnenlandsAdres (Binnenlands adres), BuitenlandsAdres (Buitenlands adres), BinnenlandsPostbusAdres (Binnenlands postbusadres), VrijeLocatie (Vrije locatie), AdresOnbekend (Adres onbekend) type: object properties: code: type: string enum: - BinnenlandsAdres - BuitenlandsAdres - BinnenlandsPostbusAdres - VrijeLocatie - AdresOnbekend omschrijving: type: string AanduidingBijBinnenlandsAdresDto: description: De aanduiding die wordt gebruikt voor adressen die niet zijn voorzien van de gebruikelijke straatnaam en huisnummeraanduidingen; bij (Bij), tegenover (Tegenover) type: object properties: code: type: string enum: - bij - tegenover omschrijving: type: string LandDto: description: Het land waar het adres zich bevindt type: object properties: code: type: string omschrijving: type: string GeoDataDto: description: Basisregistratie Adressen en Gebouwen gegevens uit het kadaster type: object properties: gpsLatitude: description: GPS Breedtegraad type: number gpsLongitude: description: GPS Lengtegraad type: number rijksdriehoekX: description: Rijksdriehoek X-coördinaat type: number rijksdriehoekY: description: Rijksdriehoek Y-coördinaat type: number rijksdriehoekZ: description: Rijksdriehoek Z-coördinaat type: number AdresDto: type: object properties: soortAdres: $ref: '#/components/schemas/SoortAdresDto' straatnaam: description: De straat van het adres type: string maxLength: 80 straatnaamHuisnummer: description: Het gegeven straatnaam/huisnummer is een combinatie van de straatnaam en het huisnummer in het buitenland type: string maxLength: 250 aanduidingBijBinnenlandsAdres: $ref: '#/components/schemas/AanduidingBijBinnenlandsAdresDto' huisnummer: description: Het huisnummer van het adres type: integer huisletter: description: De huisletter die door de gemeente is toegekend aan het huisnummer type: string pattern: '[a-zA-Z]{1}' huisnummerToevoeging: description: Een toevoeging van het adres bijvoorbeeld rood, bis, etc. type: string maxLength: 10 postcode: description: De in Nederland gangbare postcode voor een Nederlands postadres, bestaande uit een numeriek deel en een alfabetisch deel type: string pattern: ^[0-9]{4}$|^[0-9]{4}[a-zA-Z]{2}$ maxLength: 6 postcodePlaats: description: De postcode/plaats is de combinatie van een postcode en plaats in het buitenland type: string maxLength: 250 woonplaats: description: 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 type: string maxLength: 80 regio: description: Regio is een deel van het land (streek, provincie, etc.) type: string maxLength: 250 land: $ref: '#/components/schemas/LandDto' identificatieAdresseerbaarObject: description: De unieke BAG identificatie van een Adresseerbaar object. Een Adresseerbaar object is een Verblijfsobject, een Standplaats of een Ligplaats type: string maxLength: 16 identificatieNummeraanduiding: description: 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 type: string maxLength: 16 toevoegingAdres: description: 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 type: string maxLength: 100 locatiebeschrijving: description: Vrije tekst wanneer er sprake is van een vrije locatie type: string maxLength: 100 geoData: $ref: '#/components/schemas/GeoDataDto' SoortCommanditairKapitaalDto: description: Geeft aan of het commanditaire kapitaal in geld of goederen ter beschikking wordt gesteld; geld (Geld), goederen (Goederen) type: object properties: code: type: string enum: - geld - goederen omschrijving: type: string GeldDto: type: object properties: valuta: description: De valuta van de waarde van het geld volgens de ISO 4217 tabel type: string maxLength: 40 waarde: description: De waarde van het geld (in de betreffende valuta) type: string CommanditaireKapitalenDto: description: 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 type: array items: properties: soort: $ref: '#/components/schemas/SoortCommanditairKapitaalDto' bedrag: description: De waarde van het commanditair kapitaal in valuta allOf: - $ref: '#/components/schemas/GeldDto' PersonenvennootschapGegevensDto: description: Het betreft de PersonenVennootschapsGegevens van een NietNatuurlijkePersoon. 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 type: object properties: aantalCommanditaireVennoten: description: Het aantal commanditaire vennoten type: integer heeftOnbepaaldeDuur: description: Indicatie die aangeeft of de duur waarvoor de personenvennootschap is aangegaan voor onbepaalde tijd is allOf: - $ref: '#/components/schemas/IndicatieDto' eindeDuur: description: 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 type: string pattern: ^[0-9]{8}$ commanditaireKapitalen: $ref: '#/components/schemas/CommanditaireKapitalenDto' RechtsbevoegdheidVerenigingDto: description: Geeft aan of het een vereniging met een volledige of beperkte rechtsbevoegdheid is; beperkt (Beperkt) volledig (Volledig) type: object properties: code: type: string enum: - beperkt - volledig omschrijving: type: string StelselInrichtingDto: description: 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); M (Monistisch), D (Dualistisch) type: object properties: code: type: string enum: - M - D omschrijving: type: string StructuurDto: description: Geeft aan of de rechtspersoon een gewone of bijzondere structuur heeft; GS (Gewone structuur), BS (Bijzondere structuur) type: object properties: code: type: string enum: - GS - BS omschrijving: type: string RechtspersoonGegevensDto: description: Het betreft de RechtspersoonGegevens van een NietNatuurlijkePersoon. Een rechtspersoon is een zelfstandig drager van rechten en plichten, niet zijnde een NatuurlijkePersoon type: object properties: activiteitenomschrijving: description: De activiteitenomschrijving is een korte omschrijving van de feitelijk uitgeoefende activiteiten van de rechtspersoon type: string maxLength: 2000 beleggingsMijMetVeranderlijkKapitaal: description: Indicatie die aangeeft of de vennootschap een beleggingsmaatschappij is met veranderlijk kapitaal allOf: - $ref: '#/components/schemas/IndicatieDto' geplaatstKapitaal: description: 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 allOf: - $ref: '#/components/schemas/GeldDto' gestortKapitaal: description: De som van die gedeelten van de nominale waarde van de aandelen die daadwerkelijk door de aandeelhouders aan de kapitaalvennootschap is voldaan allOf: - $ref: '#/components/schemas/GeldDto' maatschappelijkKapitaal: description: Het maximale bedrag, vermeld in de statuten, waarvoor door de kapitaalvennootschap aandelen mogen worden uitgegeven allOf: - $ref: '#/components/schemas/GeldDto' rechtsbevoegdheidVereniging: $ref: '#/components/schemas/RechtsbevoegdheidVerenigingDto' stelselInrichting: $ref: '#/components/schemas/StelselInrichtingDto' structuur: $ref: '#/components/schemas/StructuurDto' meerdereSoortenAandelen: description: Indicatie die aangeeft of er verschillende soort aandelen zijn allOf: - $ref: '#/components/schemas/IndicatieDto' datumVoornemenOntbindingDoorKVK: description: De datum waarop het voornemen van de ontbinding bij de KvK in het handelsregister is geregistreerd type: string pattern: ^[0-9]{8}$ registratieTijdstipVoornemenOntbindingDoorKVK: description: Het tijdstip waarop het voornemen van de ontbinding in het handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstipDto' activiteiten: description: De verzameling van alle activiteiten van een rechtspersoon. Een rechtspersoon heeft altijd maar één hoofdactiviteit. Activiteit bevat de SBI-code met bijbehorende omschrijving van die activiteit allOf: - $ref: '#/components/schemas/ActiviteitenDto' NaamBuitenlandsRegisterDto: description: De naam waaronder het buitenlandse register naar buiten treedt type: object properties: code: type: string omschrijving: type: string BuitenlandseRegistratieDto: type: object properties: buitenlandseRegistratie: description: De combinatie van attributen over de inschrijving in het buitenlandse register type: string maxLength: 500 naamBuitenlandsRegister: $ref: '#/components/schemas/NaamBuitenlandsRegisterDto' plaatsBuitenlandsRegister: description: De plaats waar het buitenlandse register wordt gehouden type: string maxLength: 250 landBuitenlandsRegister: description: Het land waar het buitenlandse register wordt gehouden allOf: - $ref: '#/components/schemas/LandDto' inschrijfnummer: description: Het registratienummer in het buitenlands register voor ondernemingen is het nummer waaronder de buitenlandse persoon in het buitenlands register is geregistreerd type: string maxLength: 50 BuitenlandsePersoonGegevensDto: description: Het betreft BuitenlandsePersoonGegevens van een NietNatuurlijkePersoon. Een buitenlandse persoon is een persoon die is opgericht naar buitenlands recht type: object properties: datumEersteInschrijvingBuitenland: description: De datum waarop de BuitenlandsePersoon is ontstaan type: string pattern: ^[0-9]{8}$ datumFormeelBuitenlandsSinds: description: De datum waarop de BuitenlandsePersoon als formeel BuitenlandsePersoon is aangemerkt type: string pattern: ^[0-9]{8}$ landVanOprichting: description: Het land waarin de BuitenlandsePersoon is opgericht allOf: - $ref: '#/components/schemas/LandDto' geplaatstKapitaal: description: 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 allOf: - $ref: '#/components/schemas/GeldDto' buitenlandseRegistratie: description: De registratie van de buitenlandse persoon in het buitenlands register en de gegevens van dat register allOf: - $ref: '#/components/schemas/BuitenlandseRegistratieDto' OmzettingRechtsvormDto: description: Er is sprake van een OmzettingRechtsvorm voor de NietNatuurlijkePersoon type: object properties: datumOmzettingRechtsvorm: description: De datum dat de omzetting van de rechtsvorm heeft plaatsgevonden type: string pattern: ^[0-9]{8}$ registratieTijdstipOmzettingRechtsvorm: description: Het tijdstip waarop de registratieTijdstipOmzettingRechtsvorm bij de KvK in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstipDto' RedenOntbindingDto: description: Nadere specificatie wat de aanleiding voor de Ontbinding is geweest; OB (Ontbindingsbesluit), GL (Geheel ontbreken van leden), SB (Statutaire bepaling), DK (Ontbinding door de Kamer van Koophandel), RU (Rechterlijke uitspraak), SL (Staat van insolventie), OF (Opheffing faillissement wegens toestand van de boedel) type: object properties: code: type: string enum: - OB - GL - SB - DK - RU - SL - OF omschrijving: type: string OntbindingDto: description: Voor de NietNatuurlijkePersoon 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 type: object properties: datumOntbinding: description: De datum waarop de personenvennootschap of rechtspersoon is ontbonden type: string pattern: ^[0-9]{8}$ registratieTijdstipOntbinding: description: Het tijdstip waarop de inschrijving van de Ontbinding in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstipDto' redenOntbinding: $ref: '#/components/schemas/RedenOntbindingDto' datumAanvangLiquidatie: description: De datum waarop de liquidatie van de rechtspersoon of personenvennootschap is begonnen type: string pattern: ^[0-9]{8}$ datumEindeLiquidatie: description: De datum waarop bij de vereffenaar geen baten meer bekend zijn en de vennootschap of rechtspersoon ophoudt te bestaan type: string pattern: ^[0-9]{8}$ datumHeropeningLiquidatie: description: De datum waarop de liquidatie van de personenvennootschap of rechtspersoon heropend is type: string pattern: ^[0-9]{8}$ BuitenlandseRechtstoestandenDto: description: Er is voor de NietNatuurlijkePersoon een BuitenlandseRechtstoestand aanwezig. Een BuitenlandseRechtstoestand 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 type: array items: properties: beschrijving: description: De beschrijving van de buitenlandse uitspraak type: string maxLength: 625 NietNatuurlijkePersoonDto: description: Een NietNatuurlijkePersoon is een Persoon met rechten en plichten die geen NatuurlijkePersoon is type: object properties: rsin: description: Een door de KVK aan een rechtspersoon, personenvennootschap of rederij toegekend uniek nummer type: string pattern: ^[0-9]{9}$ datumAanvang: description: De datum waarop de NietNatuurlijkePersoon is opgericht type: string pattern: ^[0-9]{8}$ datumEinde: description: De datum waarop de NietNatuurlijkePersoon is beëindigd type: string pattern: ^[0-9]{8}$ registratieTijdstipInschrijving: description: De datum en het tijdstip waarop de inschrijving van de NietNatuurlijkePersoon in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstipDto' registratieTijdstipUitschrijving: description: De registratieTijdstipUitschrijving betreft de datum en het tijdstip van de registratie van beëindiging in óf uitschrijving van de NietNatuurlijkePersoon uit het Handelsregister allOf: - $ref: '#/components/schemas/RegistratieTijdstipDto' specificatieRechtsvorm: description: Een nadere aanduiding van de rechtsvorm van de publiekrechtelijke rechtspersoon, overige privaatrechtelijke rechtspersoon en buitenlandse persoon type: string maxLength: 500 datumAkteOprichting: description: De datum waarop de akte van oprichting is gepasseerd bij de notaris type: string pattern: ^[0-9]{8}$ statutaireZetel: description: De plaats of gemeente waar de NietNatuurlijkePersoon volgens zijn statuten zijn zetel heeft type: string maxLength: 60 datumAanvangLaatsteStatutenwijziging: description: De datum waarop de (laatste) statutenwijziging is ingegaan type: string pattern: ^[0-9]{8}$ datumAkteLaatsteStatutenwijziging: description: De datum waarop de akte, waarin de (laatste) statutenwijziging is opgenomen, is gepasseerd bij de notaris type: string pattern: ^[0-9]{8}$ datumUitschrijving: description: De datum dat de NietNatuurlijkPersoon is uitgeschreven type: string pattern: ^[0-9]{8}$ naamgevingen: description: De verzameling van ontdubbelde namen van alle niet-commerciële vestigingen. De volgorde van deze namen is bij volgorde bepaald allOf: - $ref: '#/components/schemas/NaamgevingenPersoonDto' communicatiegegevens: $ref: '#/components/schemas/CommunicatiegegevensDto' adres: description: Een Adres geeft een locatie aan welke kan worden bezocht of waarnaar post kan worden verzonden type: object properties: bezoekadres: description: Het Adres van een NietNatuurlijkePersoon waarop deze fysiek bereikbaar is allOf: - properties: bezoekadresAfgeschermd: description: Geeft aan of het bezoekadres, op basis van een afschermingsverzoek, afgeschermd is of niet allOf: - $ref: '#/components/schemas/IndicatieDto' - $ref: '#/components/schemas/AdresDto' postadres: description: Het Adres van een NietNatuurlijkePersoon voor correspondentie allOf: - properties: postbusnummer: description: Het nummer van een postbus dat wordt gebruikt als postadres type: integer - $ref: '#/components/schemas/AdresDto' personenvennootschapGegevens: $ref: '#/components/schemas/PersonenvennootschapGegevensDto' rechtspersoonGegevens: $ref: '#/components/schemas/RechtspersoonGegevensDto' buitenlandsePersoonGegevens: $ref: '#/components/schemas/BuitenlandsePersoonGegevensDto' omzettingRechtsvorm: $ref: '#/components/schemas/OmzettingRechtsvormDto' ontbinding: $ref: '#/components/schemas/OntbindingDto' buitenlandseRechtstoestanden: $ref: '#/components/schemas/BuitenlandseRechtstoestandenDto' PersoonGegevensDto: description: 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 type: object properties: bijzondereRechtstoestand: $ref: '#/components/schemas/BijzondereRechtstoestandDto' nietNatuurlijkePersoon: $ref: '#/components/schemas/NietNatuurlijkePersoonDto' SoortVestigingDto: description: Geeft aan of deze vestiging een hoofdvestiging of nevenvestiging is; Hoofdvestiging (Hoofdvestiging), Nevenvestiging (Nevenvestiging) type: object properties: code: type: string enum: - Hoofdvestiging - Nevenvestiging omschrijving: type: string ItemsDto: type: object properties: items: type: array items: properties: links: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore' allOf: - $ref: '#/components/schemas/LinksDto' vestigingsnummer: description: Het identificerende gegeven van de Vestiging. Uniek nummer dat bestaat uit 12 cijfers type: string pattern: ^[0-9]{12}$ soortVestiging: $ref: '#/components/schemas/SoortVestigingDto' MaatschappelijkeActiviteitDto: x-implements: - Organisatie type: object properties: links: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore' allOf: - $ref: '#/components/schemas/LinksDto' algemeen: $ref: '#/components/schemas/AlgemeenDto' maatschappelijkeActiviteit: $ref: '#/components/schemas/MaatschappelijkeActiviteitGegevensDto' OndernemingDto: x-implements: - Organisatie type: object properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' onderneming: $ref: '#/components/schemas/OndernemingGegevensDto' PersoonDto: x-implements: - Organisatie type: object properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' persoon: $ref: '#/components/schemas/PersoonGegevensDto' VestigingenDto: x-implements: - Organisatie type: object properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' vestigingen: $ref: '#/components/schemas/ItemsDto' responses: DefaultError: description: Er is een onverwachte fout opgetreden content: application/json: schema: $ref: '#/components/schemas/Error' BadRequest: description: Een opgegeven parameter is niet valide content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Geen of onjuist JWT token aangeleverd content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: Niet geautoriseerd voor deze operatie content: application/json: schema: $ref: '#/components/schemas/Error' NotFound: description: Er zijn geen resultaten gevonden aan de hand van de opgegeven parameter(s) content: application/json: schema: $ref: '#/components/schemas/Error' NotAcceptable: description: Opgegeven Accept header wordt niet ondersteund content: application/json: schema: $ref: '#/components/schemas/Error' InternalServerError: description: Er is een interne fout opgetreden content: application/json: schema: $ref: '#/components/schemas/Error' headers: api_version: schema: type: string description: Geeft een specifieke API-versie aan in de context van een specifieke aanroep example: 1.0.0 warning: schema: type: string description: Zie RFC 7234. In het geval een major versie wordt uitgefaseerd, gebruiken we warn-code 299 ('Miscellaneous Persistent Warning') en het API end-point (inclusief versienummer) als de warn-agent van de warning, gevolgd door de warn-text met de human-readable waarschuwing example: '299 https://api.kvk.nl/api/v1/testnaam/ ''Deze versie van de API is verouderd en zal uit dienst worden genomen op 2025-02-01. Raadpleeg voor meer informatie hier de documentatie: https://developers.kvk.nl/nl/apis/testnaam''.'