openapi: 3.0.1 info: title: Functionaris API description: Functionarissen opvragen van een specifieke 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: functionaris externalDocs: description: Voor meer informatie over deze API url: https://developers.kvk.nl/nl/support paths: /v1/functionarissen/kvknummer/{kvkNummer}: get: tags: - functionaris summary: Voor een specifieke organisatie functionarissen opvragen op basis van een kvkNummer operationId: functionarisBijKvkNummer parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '59581883' required: true schema: pattern: ^[0-9]{8}$ type: string - name: type in: query description: Filter op type functionaris schema: type: array items: type: string enum: - aansprakelijke - bestuursfunctie - bijzondereRechtstoestandFunctie - eigenaar - gemachtigde - overigeFunctie - publiekrechtelijkeFunctie example: type=aansprakelijke&type=bestuursfunctie 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/FunctionarissenDto' '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/functionarissen/kvknummer/{kvkNummer}/vestigingsnummer/{vestigingsnummer}: get: tags: - functionaris summary: Voor een specifieke organisatie gemachtigden opvragen op basis van een kvkNummer en vestigingsnummer operationId: functionarisBijVestigingsnummer parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '59581883' required: true schema: pattern: ^[0-9]{8}$ type: string - name: vestigingsnummer in: path description: Betreft het identificerende gegeven van de Vestiging example: '000003038092' required: true schema: pattern: ^[0-9]{12}$ 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/FunctionarisVestigingDto' '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/functionarissen/kvknummer/{kvkNummer}/eigenaar: get: tags: - eigenaar summary: Eigenaar van een eenmanszaak opvragen op basis van een kvkNummer operationId: eigenaar parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '59581883' 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/EigenaarDto' '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/functionarissen/kvknummer/{kvkNummer}/overigefuncties: get: tags: - overigeFuncties summary: Overige functies opvragen op basis van een kvkNummer. operationId: overigeFuncties parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '59581883' 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/OverigeFunctiesDto' '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/functionarissen/kvknummer/{kvkNummer}/publiekrechtelijkefuncties: get: tags: - publiekrechtelijkeFuncties summary: Publiekrechtelijke functies opvragen op basis van een kvkNummer. operationId: publiekrechtelijkeFuncties parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '59581883' 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/PubliekrechtelijkeFunctiesDto' '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/functionarissen/kvknummer/{kvkNummer}/aansprakelijken: get: tags: - aansprakelijken summary: Aansprakelijken opvragen op basis van een kvkNummer. operationId: aansprakelijken parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '59581883' 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/AansprakelijkenDto' '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/functionarissen/kvknummer/{kvkNummer}/bestuursfuncties: get: tags: - bestuursfuncties summary: Bestuursfuncties opvragen op basis van een kvkNummer. operationId: bestuursfuncties parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '59581883' 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/BestuursFunctiesDto' '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/functionarissen/kvknummer/{kvkNummer}/bijzondererechtstoestandfuncties: get: tags: - bijzondereRechtstoestandFuncties summary: Bijzondere Rechtstoestand functies opvragen op basis van een kvkNummer. operationId: bijzondereRechtstoestandFuncties parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '59581883' 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/BijzondereRechtstoestandFunctiesDto' '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/functionarissen/kvknummer/{kvkNummer}/gemachtigden: get: tags: - gemachtigden summary: Gemachtigden opvragen op basis van een kvkNummer. operationId: gemachtigden parameters: - name: kvkNummer in: path description: 'Een door de KVK toegekend uniek (identificerend) nummer: het Nederlands Kamer van Koophandel nummer' example: '59581883' 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/GemachtigdenDto' '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: schemas: FunctionarisVestigingDto: x-implements: - Functionaris type: object required: - vestigingsNummer properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' gemachtigden: $ref: '#/components/schemas/GemachtigdenGegevensDto' FunctionarissenDto: x-implements: - Functionaris type: object required: - kvkNummer properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' eigenaar: properties: links: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore' allOf: - $ref: '#/components/schemas/LinksDto' gegevens: $ref: '#/components/schemas/EigenaarGegevensDto' overigeFuncties: 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/OverigeFunctieGegegevensDto' publiekrechtelijkeFuncties: 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/PubliekrechtelijkeFunctieGegevensDto' aansprakelijken: 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/AansprakelijkeGegevensDto' bestuursfuncties: 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/BestuursfunctieGegevensDto' bijzondereRechtstoestandFuncties: 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/BijzondereRechtstoestandFunctieGegevensDto' gemachtigden: 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/GemachtigdenGegevensDto' EigenaarDto: x-implements: - Functionaris type: object properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' eigenaar: $ref: '#/components/schemas/EigenaarGegevensDto' OverigeFunctiesDto: x-implements: - Functionaris type: object properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' overigeFuncties: $ref: '#/components/schemas/OverigeFunctieGegegevensDto' OverigeFunctieGegegevensDto: type: object properties: functionarisGegevens: type: array items: $ref: '#/components/schemas/OverigeFunctieDto' PubliekrechtelijkeFunctiesDto: x-implements: - Functionaris type: object properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' publiekrechtelijkeFuncties: $ref: '#/components/schemas/PubliekrechtelijkeFunctieGegevensDto' PubliekrechtelijkeFunctieGegevensDto: type: object properties: functionarisGegevens: type: array items: $ref: '#/components/schemas/PubliekrechtelijkeFunctieDto' AansprakelijkenDto: x-implements: - Functionaris type: object properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' aansprakelijken: $ref: '#/components/schemas/AansprakelijkeGegevensDto' AansprakelijkeGegevensDto: type: object properties: functionarisGegevens: type: array items: $ref: '#/components/schemas/AansprakelijkeDto' BestuursfunctiesDto: x-implements: - Functionaris type: object properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' bestuursfuncties: $ref: '#/components/schemas/BestuursfunctieGegevensDto' BestuursfunctieGegevensDto: type: object properties: functionarisGegevens: type: array items: $ref: '#/components/schemas/BestuursfunctieDto' BijzondereRechtstoestandFunctiesDto: x-implements: - Functionaris type: object properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' bijzondereRechtstoestandFuncties: $ref: '#/components/schemas/BijzondereRechtstoestandFunctieGegevensDto' BijzondereRechtstoestandFunctieGegevensDto: type: object properties: functionarisGegevens: type: array items: $ref: '#/components/schemas/BijzondereRechtstoestandFunctieDto' GemachtigdenDto: x-implements: - Functionaris type: object properties: algemeen: $ref: '#/components/schemas/AlgemeenDto' gemachtigden: $ref: '#/components/schemas/GemachtigdenGegevensDto' GemachtigdenGegevensDto: type: object properties: functionarisGegevens: type: array items: $ref: '#/components/schemas/GemachtigdeDto' EigenaarGegevensDto: description: De eigenaar van een Eenmanszaak type: object properties: bsn: description: Het burgerservicenummer (BSN) van de NatuurlijkePersoon. Dit gegeven is niet openbaar en wordt uitsluitend geleverd aan afnemers die zijn geautoriseerd tot het Inzien van Privé Persoonsgegevens (IPP) zoals bedoeld in artikel 28 lid 1 Handelsregisterwet 2007 type: string pattern: ^[0-9]{9}$ naamEigenaar: description: De volledige naam van de Persoon, die eigenaar is van de maatschappelijke activiteit type: string maxLength: 625 voornamen: description: Voornaam of voornamen van de NatuurlijkePersoon type: string maxLength: 200 voorvoegsel: description: De (eventuele) voorvoegsels van de naam van de NatuurlijkePersoon type: string maxLength: 10 achternaam: description: De (samengestelde) achternaam van de NatuurlijkePersoon op basis van het naamgebruik dat is vastgelegd in het BRP type: string maxLength: 200 adellijkeTitel: description: De adellijke titel van de NatuurlijkePersoon type: string maxLength: 10 geboortedatum: description: Geboortedatum van de NatuurlijkePersoon type: string pattern: ^[0-9]{8}$ overlijdensdatum: description: Overlijdensdatum van de NatuurlijkePersoon type: string pattern: ^[0-9]{8}$ datumVertrokken: description: Datum die aangeeft wanneer de NatuurlijkePersoon is vertrokken naar een niet bekend adres in het buitenland. In het Adres blijft het laatst bekende woonadres staan. Dit gegeven is niet openbaar en wordt uitsluitend geleverd aan afnemers die geautoriseerd zijn tot het Inzien van Privé Adressen (IPA) zoals bedoeld in artikel 28 lid 1 Handelsregisterwet 2007 type: string pattern: ^[0-9]{8}$ geboorteplaats: description: De plaats waar de NatuurlijkePersoon is geboren. Dit gegeven is niet openbaar en wordt uitsluitend geleverd aan afnemers die zijn geautoriseerd tot het Inzien van Privé Persoonsgegevens (IPP) zoals bedoeld in artikel 28 lid 1 Handelsregisterwet 2007 type: string maxLength: 200 geboorteland: $ref: '#/components/schemas/GeboortelandDto' adres: description: Een adres geeft een locatie aan welke kan worden bezocht of waarop een NatuurlijkePersoon bereikbaar is type: object properties: woonadres: description: Het adres van een NatuurlijkePersoon waar deze woonachtig is allOf: - $ref: '#/components/schemas/AdresDto' handlichting: description: De NatuurlijkePersoon, die eigenaar is van een onderneming heeft handlichting verkregen. Handlichting betreft het verlenen van bevoegdheden aan een zestien- of zeventienjarige minderjarige die anders alleen toekomen aan meerderjarigen allOf: - $ref: '#/components/schemas/HandlichtingDto' OverigeFunctieDto: description: Een functionaris welke niet onder één van de andere soort functies valt allOf: - $ref: '#/components/schemas/FunctionarisDto' - type: object properties: functie: description: Een nadere aanduiding van een overige functionaris; (10) Bewaarder boeken en bescheiden (03) Commissaris (08) Enig aandeelhouder (30) Functionaris volgens buitenlands recht (05) Aandeelhouder niet volgestorte aandelen (17) Lid EESV (04) Lid van het toezichthoudend orgaan (09) Vereffenaar volgens buitenlands recht properties: code: type: string enum: - '10' - '03' - '08' - '30' - '05' - '17' - '04' - '09' omschrijving: type: string soortBevoegdheid: description: De soort bevoegdheid die een functionaris volgens buitenlands recht of de vereffenaar kan hebben; (azb) Alleen/zelfstandig bevoegd (bevoegd) Bevoegd tot vertegenwoordigen (zie opgaaf) (ob) Onbeperkt bevoegd (bb) Beperkt bevoegd (gb) Gezamenlijk bevoegd (nb) Niet bevoegd properties: code: type: string enum: - azb - bevoegd - ob - bb - gb - nb omschrijving: type: string datumAanvangBevoegdheid: description: De datum waarop de bevoegdheid van de functionaris is gestart type: string pattern: ^[0-9]{8}$ datumEindeBevoegdheid: description: De datum waarop de bevoegdheid van de functionaris is beëindigd type: string pattern: ^[0-9]{8}$ registratieTijdstipBevoegdheid: description: De datum en het tijdstip waarop de bevoegdheid van de functionaris in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstip' geplaatstKapitaal: description: Dit gegeven betreft het geplaatst kapitaal van een aandeelhouder met niet-volgestorte aandelen. Het geplaatste kapitaal is de totale nominale waarde van alle aandelen die de kapitaalvennootschap heeft uitgegeven. Alleen het totaalbedrag wordt verstrekt allOf: - $ref: '#/components/schemas/GeldDto' gestortKapitaal: description: Dit gegeven betreft het gestort kapitaal van een aandeelhouder met niet-volgestorte aandelen. Het gestorte deel van het kapitaal is de som van die gedeelten van de nominale waarde van de aandelen die daadwerkelijk door de aandeelhouders aan de kapitaalvennootschap is voldaan. Alleen het totaalbedrag wordt verstrekt allOf: - $ref: '#/components/schemas/GeldDto' heeftAfwijkendAansprakelijkheidsbeding: description: Indicatie dat er een afwijkende aansprakelijkheidsbeding van leden geregistreerd is bij een EESV allOf: - $ref: '#/components/schemas/IndicatieDto' PubliekrechtelijkeFunctieDto: type: object description: Een functionaris die werkzaam is bij een publiekrechtelijke rechtspersoon allOf: - $ref: '#/components/schemas/FunctionarisDto' - type: object properties: functie: description: Een nadere aanduiding van de publiekrechtelijke functionaris; (25) Publiekrechtelijk bestuurder (26) Publiekrechtelijk commissaris (27) Publiekrechtelijk lid toezichthoudend orgaan properties: code: type: string enum: - '25' - '26' - '27' omschrijving: type: string soortBevoegdheid: description: De bevoegdheid die een functionaris van een publiekrechtelijke rechtspersoon kan hebben. De bevoegdheid kan één van de volgende soorten zijn; (nbtv) Niet bevoegd tot vertegenwoordigen (btv) Bevoegd tot vertegenwoordigen (zie opgaaf) properties: code: type: string enum: - nbtv - btv omschrijving: type: string datumAanvangBevoegdheid: description: De datum waarop de bevoegdheid van de functionaris is gestart type: string pattern: ^[0-9]{8}$ datumEindeBevoegdheid: description: De datum waarop de bevoegdheid van de functionaris is beëindigd type: string pattern: ^[0-9]{8}$ registratieTijdstipBevoegdheid: description: De datum en het tijdstip waarop de bevoegdheid van de functionaris in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstip' AansprakelijkeDto: description: Een functionaris die hoofdelijk aansprakelijk is voor de schulden van een personenvennootschap, rederij, eenmanszaak met meerdere eigenaren of rechtspersoon in oprichting allOf: - $ref: '#/components/schemas/FunctionarisDto' - type: object properties: functie: description: Een nadere aanduiding van de aansprakelijke; (12) Mede-eigenaar (13) Vennoot (15) Maat (16) Lid rederij (28) Bevoegd functionaris properties: code: type: string enum: - '12' - '13' - '15' - '16' - '28' omschrijving: type: string soortBevoegdheid: description: De bevoegdheid van een aansprakelijke; (ob) Onbeperkt bevoegd (bb) Beperkt bevoegd (nb) Niet bevoegd properties: code: type: string enum: - ob - bb - nb omschrijving: type: string beperkingInGeld: description: De bevoegdheid is beperkt tot het genoemde bedrag in euro's allOf: - $ref: '#/components/schemas/GeldDto' overigeBeperking: description: Indicatie of er een andere beperking voor de aansprakelijke geldt, anders dan het genoemde bedrag. De verdere details van de aansprakelijkheid worden in de opgave vermeld en welke zijn te vinden in de opgeslagen documenten van het Handelsregister allOf: - $ref: '#/components/schemas/IndicatieDto' datumAanvangBevoegdheid: description: De datum waarop de bevoegdheid van de functionaris is gestart type: string pattern: ^[0-9]{8}$ datumEindeBevoegdheid: description: De datum waarop de bevoegdheid van de functionaris is beëindigd type: string pattern: ^[0-9]{8}$ registratieTijdstipBevoegdheid: description: De datum en het tijdstip waarop de bevoegdheid van de functionaris in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstip' handlichting: description: De NatuurlijkePersoon, die aansprakelijke is van een personenvennootschap, heeft handlichting verkregen. Handlichting betreft het verlenen van bevoegdheden aan een zestien- of zeventienjarige minderjarige die anders alleen toekomen aan meerderjarigen allOf: - $ref: '#/components/schemas/HandlichtingDto' BestuursFunctieDto: description: Een functionaris die als bestuurder de leiding heeft over een rechtspersoon en verantwoording draagt voor de dagelijkse gang van zaken binnen de rechtspersoon en zich daarbij richt naar het belang van de rechtspersoon allOf: - $ref: '#/components/schemas/FunctionarisDto' - type: object properties: functie: description: Een nadere aanduiding van de bestuursfunctie; (02) Bestuurder (18) Lid van het besturend orgaan (19) Lid van het leidinggevend orgaan (20) Persoon krachtens statuten bevoegd bij ontstentenis of belet van de bestuurders properties: code: type: string enum: - '02' - '18' - '19' - '20' omschrijving: type: string soortBevoegdheid: description: De bevoegdheid van een functionaris met bestuursfunctie; (azb) alleen/zelfstandig bevoegd (gb) Gezamenlijk bevoegd (nb) Niet bevoegd properties: code: type: string enum: - azb - gb - nb omschrijving: type: string isBevoegdMetAnderePersonen: description: Indicatie die aangeeft of er een gezamenlijke bevoegdheid is met andere personen niet zijnde bestuurders. Meer informatie is opgenomen in de statuten van de rechtspersoon allOf: - $ref: '#/components/schemas/IndicatieDto' datumAanvangBevoegdheid: description: De datum waarop de bevoegdheid van de functionaris is gestart type: string pattern: ^[0-9]{8}$ datumEindeBevoegdheid: description: De datum waarop de bevoegdheid van de functionaris is beëindigd type: string pattern: ^[0-9]{8}$ registratieTijdstipBevoegdheid: description: De datum en het tijdstip waarop de bevoegdheid van de functionaris in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstip' soortMonistischBestuurder: description: De rol die de monistische bestuurder vervult bij de Rechtspersoon; (u) Uitvoerende bestuurder (n) Niet uitvoerende bestuurder properties: code: type: string enum: - u - 'n' omschrijving: type: string vertegenwoordigerBestuurderRechtspersoon: description: Een functionaris die als vertegenwoordiger is aangewezen van de rechtspersoon die bestuurder is bij een EESV properties: datumAanvangVertegenwoordiger: description: De datum waarop de vertegenwoordiging tot stand is gekomen type: string pattern: ^[0-9]{8}$ registratieTijdstipVertegenwoordiger: description: Het datum en het tijdstip waarop de vertegenwoordiger bestuurder rechtspersoon bij de KVK in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstip' persoonlijkeGegevens: description: De persoonlijkeGegevens van een NatuurlijkePersoon die de rechtspersoon vertegenwoordigd, indien die een Bestuursfunctie bij een EESV vervult allOf: - $ref: '#/components/schemas/PersoonlijkeGegevensDto' BijzondereRechtstoestandFunctieDto: description: Een Functionaris die werkzaam is bij een Persoon in het kader van een bijzondere rechtstoestand allOf: - $ref: '#/components/schemas/FunctionarisDto' - type: object properties: functie: description: Een nadere aanduiding van een bijzondere rechtstoestand functie; (07) Curator (06) Bewindvoerder (11) Rechter-commissaris properties: code: type: string enum: - '07' - '06' - '11' omschrijving: type: string soortBevoegdheid: description: Geeft het soort bevoegdheid van de bewindvoerder aan; (abz) Alleen/zelfstandig bevoegd (gb) Gezamenlijk bevoegd properties: code: type: string enum: - azb - gb omschrijving: type: string datumAanvangBevoegdheid: description: De datum waarop de bevoegdheid van de functionaris is gestart type: string pattern: ^[0-9]{8}$ datumEindeBevoegdheid: description: De datum waarop de bevoegdheid van de functionaris is beëindigd type: string pattern: ^[0-9]{8}$ registratieTijdstipBevoegdheid: description: De datum en het tijdstip waarop de bevoegdheid van de functionaris in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstip' GemachtigdeDto: type: object description: Een functionaris aan wie een volmacht is verleend door een Persoon allOf: - $ref: '#/components/schemas/FunctionarisDto' - type: object properties: functie: description: Een nadere aanduiding van de gemachtigde; (01) Gevolmachtigde, (21) Handelsagent, (22) Beheerder, (23) Boekhouder, (24) Privaatrechtelijk gevolmachtigde properties: code: type: string enum: - '01' - '21' - '22' - '23' - '24' omschrijving: type: string typeVolmacht: description: Geeft het soort volmacht aan van de gemachtigde; (b) Beperkte volmacht (v) Volledige volmacht properties: code: type: string enum: - b - v omschrijving: type: string beperkingInGeld: description: Een bedrag tot waar de gemachtigde is bevoegd om rechtshandelingen te verrichten allOf: - $ref: '#/components/schemas/GeldDto' heeftOverigeBeperkteVolmacht: description: Indicatie dat een gemachtigde bevoegdheden heeft die niet-gestructureerd zijn vastgelegd in het Handelsregister. Informatie over de bevoegdheid is beschikbaar via de bij de opgave opgeslagen documenten allOf: - $ref: '#/components/schemas/IndicatieDto' magOpgaveHandelsregisterDoen: description: Indicatie dat een gemachtigde is bevoegd tot het doen van opgave aan het Handelsregister allOf: - $ref: '#/components/schemas/IndicatieDto' omschrijvingOverigeBeperkteVolmacht: description: De omschrijving van de niet-gestructureerd vastgelegde bevoegdheid in het Handelsregister type: string maxLength: 200 datumAanvangVolmacht: description: De datum waarop de beperkte- of volledige volmacht is verleend type: string pattern: ^[0-9]{8}$ datumEindeVolmacht: description: De datum waarop de beperkte- of volledige volmacht is beëindigd type: string pattern: ^[0-9]{8}$ registratieTijdstipVolmacht: description: De datum en het tijdstip waarop de bevoegdheid van de functionaris in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstip' beperkingInHandeling: description: De volmacht is beperkt tot één of meerdere specifieke handelingen. Indien de volmacht betrekking heeft op één of meerdere handelingen, dan is er sprake van een beperkte volmacht. Bij een beperkte volmacht van een Gemachtigde kunnen gestructureerde beperkingen in handelen aanwezig zijn, al dan niet in combinatie met een maximumbedrag type: array items: $ref: '#/components/schemas/BeperkingInHandelingDto' vestigingen: description: De volmacht van de gemachtigde is beperkt tot één of meerdere vestigingen. Indien de volmacht betrekking heeft op één of meerdere vestigingen, dan is er sprake van een beperkte volmacht type: array items: $ref: '#/components/schemas/VestigingenDto' VestigingenDto: type: object properties: links: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore' allOf: - $ref: '#/components/schemas/LinksDto' vestigingsnummer: description: Betreft het identificerende gegeven van de vestiging type: string pattern: ^[0-9]{12}$ BeperkingInHandelingDto: type: object properties: beperkingInGeld: description: Indien de gemachtigde een (gestructureerde) beperking in handelen heeft kan daarvoor een beperking tot een bepaald bedrag in geld worden opgegeven allOf: - $ref: '#/components/schemas/GeldDto' soortHandeling: description: Indien de gemachtigde een gestructureerde beperking in handelen heeft welke gekozen kan worden uit een standaardlijst allOf: - $ref: '#/components/schemas/BeperkingInHandelingSoortGemachtigdeDto' BeperkingInHandelingSoortGemachtigdeDto: description: Indien de gemachtigde een gestructureerde beperking in handelen heeft kan gekozen worden uit een standaardlijst met beperkingen; (afslfin) Afsluiten financieringscontracten (afslgar) Afsluiten garantieovereenkomsten (afsllic) Afsluiten inkoopcontracten (afslc) Afsluiten leasecontracten (afsloc) Afsluiten onderhoudscontracten (afslsc) Afsluiten software-contracten (afslvc) Afsluiten verkoopcontracten (uitvvervact) Leidinggeven aan vervoersactiviteiten (opstoff) Opstellen offertes (RDWSOLZ) RDW eDienst Schorsen Voertuigen (RDWEKD) RDW eDienst Kentekendiensten properties: code: enum: - afslfin - afslgar - afsllic - afslc - afsloc - afslsc - afslvc - uitvvervact - opstoff - RDWSOLZ - RDWEKD omschrijving: type: string 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' LinksDto: type: object required: - href properties: href: type: string title: type: string IndicatieDto: 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: links: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore' allOf: - $ref: '#/components/schemas/LinksDto' 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' GeboortelandDto: description: Het land waar de NatuurlijkePersoon is geboren. Dit gegeven is niet openbaar en wordt uitsluitend geleverd aan afnemers die zijn geautoriseerd tot het Inzien van Privé Persoonsgegevens (IPP) zoals bedoeld in artikel 28 lid 1 Handelsregisterwet 2007 type: object properties: code: type: string omschrijving: type: string SoortAdresDto: description: Geeft aan welk soort adres het betreft. Het adres kan één van de volgende soorten zijn; BinnenlandsAdres BuitenlandsAdres BinnenlandsPostbusAdres VrijeLocatie AdresOnbekend type: object properties: code: type: string enum: - BinnenlandsAdres - BuitenlandsAdres - BinnenlandsPostbusAdres - VrijeLocatie - AdresOnbekend omschrijving: type: string LandDto: description: Het land waar het adres zich bevindt type: object properties: code: type: string omschrijving: type: string 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: description: 'De aanduiding die wordt gebruikt voor adressen die niet zijn voorzien van de gebruikelijke straatnaam en huisnummeraanduidingen. Mogelijke waarden zijn: bij, tegenover' type: object properties: code: type: string enum: - bij - tegenover omschrijving: type: string huisnummer: description: Het huisnummer van het adres type: integer huisletter: description: De huisletter die door gemeente is toegekend aan het huisnummer type: string pattern: ^[a-z,A-Z]{1}$ huisnummerToevoeging: description: Een toevoeging van het adres bijvoorbeeld rood, bis, etc type: string maxLength: 10 postbusnummer: description: Het nummer van een postbus dat wordt gebruikt als postadres type: integer 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}([a-zA-Z]{2})?$ 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 RegistratieTijdstip: type: object properties: soortRegistratieTijdstip: properties: code: type: string enum: - DATUMTIJDSTIP - VASTGESTELD_ONBEKEND omschrijving: type: string waarde: type: string HandlichtingDto: type: object properties: datumAanvang: description: De datum waarop de handlichting is ingegaan die door de rechter is verleend aan de (aansprakelijke) NatuurlijkePersoon type: string pattern: ^[0-9]{8}$ registratieTijdstipHandlichting: description: Het tijdstip waarop de handlichting bij de KVK in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstip' SoortFunctionarisDto: description: 'Dit is één van de onderstaande soorten: NatuurlijkePersoon, NietNatuurlijkePersoon, NaamPersoon, AnoniemePersoon. Afhankelijk van de soortFunctionaris worden voor de functionaris de gegevens ingevuld bij PersoonlijkeGegevens. Alleen voor de anonieme persoon worden er geen persoonlijke gegevens geregistreerd van de functionaris' type: object properties: code: type: string enum: - NatuurlijkePersoon - NietNatuurlijkePersoon - NaamPersoon - AnoniemePersoon omschrijving: type: string TelefoonnummerDto: description: Het telefoonnummer waarop de NaamPersoon bereikbaar is type: object properties: landnummer: description: De internationale toegangscode van het land dat hoort bij het telefoonnummer type: string pattern: ^([+])?[0-9]{2,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 pattern: ^[0-9]{15}$ 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/RegistratieTijdstip' 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' - type: object 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' - type: object properties: soort: $ref: '#/components/schemas/BeperkingInRechtshandelingSoortDto' BijzondereRechtstoestandDto: description: BijzondereRechtstoestand geeft aan of er voor een functionaris, NatuurlijkePersoon of NietNatuurlijkePersoon, een Insolventie of BeperkingInRechtshandeling aanwezig is type: object x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonUnwrapped' properties: links: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore' allOf: - $ref: '#/components/schemas/LinksDto' insolventie: allOf: - $ref: '#/components/schemas/InsolventieDto' beperkingInRechtshandeling: $ref: '#/components/schemas/BeperkingInRechtshandelingDto' PersoonlijkeGegevensDto: description: Deze groep bevat de PersoonlijkeGegevens van een Functionaris indien dit een NatuurlijkePersoon of NietNatuurlijkePersoon betreft type: object properties: bsn: description: Het burgerservicenummer (BSN) van de NatuurlijkePersoon. Dit gegeven is niet openbaar en wordt uitsluitend geleverd aan afnemers die zijn geautoriseerd tot het Inzien van Privé Persoonsgegevens (IPP) zoals bedoeld in artikel 28 lid 1 Handelsregisterwet 2007 type: string pattern: ^[0-9]{9}$ naamFunctionaris: description: Volledige naam van de persoon, die Functionaris is type: string maxLength: 625 voornamen: description: Voornaam of voornamen van de NatuurlijkePersoon type: string maxLength: 200 voorvoegsel: description: De (eventuele) voorvoegsels van de naam van de NatuurlijkePersoon type: string maxLength: 10 achternaam: description: De (samengestelde) achternaam van de NatuurlijkePersoon op basis van het naamgebruik dat is vastgelegd in het BRP type: string maxLength: 200 adellijkeTitel: description: De adellijke titel van de NatuurlijkePersoon type: string maxLength: 10 geboortedatum: description: Geboortedatum van de NatuurlijkePersoon type: string pattern: ^[0-9]{8}$ overlijdensdatum: description: Overlijdensdatum van de NatuurlijkePersoon type: string pattern: ^[0-9]{8}$ datumVertrokken: description: Datum die aangeeft wanneer de NatuurlijkePersoon is vertrokken naar een niet bekend adres in het buitenland. In het Adres blijft het laatst bekende woonadres staan. Dit gegeven is niet openbaar en wordt uitsluitend geleverd aan afnemers die geautoriseerd zijn tot het Inzien van Privé Adressen (IPA) zoals bedoeld in artikel 28 lid 1 Handelsregisterwet 2007 type: string pattern: ^[0-9]{8}$ geboorteplaats: description: De plaats waar de NatuurlijkePersoon is geboren. Dit gegeven is niet openbaar en wordt uitsluitend geleverd aan afnemers die zijn geautoriseerd tot het Inzien van Privé Persoonsgegevens (IPP) zoals bedoeld in artikel 28 lid 1 Handelsregisterwet 2007 type: string maxLength: 200 geboorteland: $ref: '#/components/schemas/GeboortelandDto' kvkNummer: description: Een door de KVK toegekend uniek nummer aan een onderneming of aan de activiteiten van een rechtspersoon waaraan geen onderneming toebehoort type: string pattern: ^[0-9]{8}$ rsin: description: Het door een kamer toegekend uniek nummer voor de NietNatuurlijkePersoon type: string pattern: ^[0-9]{9}$ links: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore' allOf: - $ref: '#/components/schemas/LinksDto' naam: description: Bevat de naam van een NatuurlijkePersoon waarvoor alleen de naam wordt vastgelegd in het Handelsregister. Dit is van toepassing op de functie curator, rechter-commissaris of bewindvoerder type: string maxLength: 625 telefoonnummer: $ref: '#/components/schemas/TelefoonnummerDto' buitenlandseRegistratie: description: De gegevens van de registratie van de buitenlandse persoon (functionaris) in het buitenlandse register en de gegevens van dat register properties: links: x-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore' allOf: - $ref: '#/components/schemas/LinksDto' adres: description: Dit gegeven betreft het Adres van de functionaris. Voor de NatuurlijkePersoon betreft dit het woonadres. Voor de NietNatuurlijkePersoon betreft dit het bezoekadres van de onderneming of rechtspersoon. Voor de NaamPersoon betreft dit het Adres properties: adres: description: Het Adres van een NaamPersoon waarop deze bereikbaar is allOf: - $ref: '#/components/schemas/AdresDto' 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' woonadres: description: Het Adres van een NatuurlijkePersoon waar deze woonachtig is allOf: - $ref: '#/components/schemas/AdresDto' bijzondereRechtstoestand: $ref: '#/components/schemas/BijzondereRechtstoestandDto' FunctionarisDto: description: 'Een functionaris is een persoon die een functie vervult binnen een onderneming of rechtspersoon. Functionaris wordt gebruikt als overkoepelend begrip voor een onderverdeling naar soort functionaris. De volgende soorten zijn mogelijk: OverigeFunctie PubliekrechtelijkeFunctie Gemachtigde Bestuursfunctie BijzondereRechtstoestandFunctie Aansprakelijke' type: object properties: datumAanvang: description: De datum waarop de functionaris in functie is getreden type: string pattern: ^[0-9]{8}$ datumEinde: description: De datum waarop de functionaris uit functie is getreden type: string pattern: ^[0-9]{8}$ registratieTijdstipInschrijving: description: De datum en het tijdstip waarop de functionaris in het Handelsregister is geregistreerd allOf: - $ref: '#/components/schemas/RegistratieTijdstip' registratieTijdstipUitschrijving: description: De datum en het tijdstip van de registratie van beëindiging in óf uitschrijving van de functionaris uit het Handelsregister allOf: - $ref: '#/components/schemas/RegistratieTijdstip' datumAanvangSchorsing: description: Dit gegeven geeft aan of en vanaf welke datum de functionaris is geschorst type: string pattern: ^[0-9]{8}$ datumUitspraak: description: Datum waarop de uitspraak tot schorsing door de rechter is gedaan type: string pattern: ^[0-9]{8}$ naamGerecht: description: De rechtbank waar de uitspraak tot schorsing heeft plaatsgevonden type: string maxLength: 500 plaatsGerecht: description: De plaats van de rechtbank waar de uitspraak tot schorsing heeft plaatsgevonden type: string maxLength: 80 soortFunctie: description: De omschrijving van de functie van de functionaris type: string maxLength: 200 titel: description: Een titel is de naam van de functionaris zoals deze naar buiten treedt. Een titel wordt verstrekt wanneer deze afwijkt van de 'functie' type: string maxLength: 250 isStatutaireTitel: description: Indicatie of de titel in de statuten is opgenomen allOf: - $ref: '#/components/schemas/IndicatieDto' soortFunctionaris: $ref: '#/components/schemas/SoortFunctionarisDto' soortVertegenwoordigingsbevoegdheid: description: De omschrijving van de bevoegdheid van de functionaris type: string maxLength: 200 persoonlijkeGegevens: $ref: '#/components/schemas/PersoonlijkeGegevensDto' 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 maxLength: 25 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 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 onjuiste JWT 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".'