KVK Handelsregister Basisprofiel API
Look up basic information of registrations with the KVK number. For example, social activity, details of owner/main location, and a list of locations.
Endpoint
https://api.kvk.nl/api/v1/basisprofielen
Swagger-UI
Test the API with Swagger-UI. It shows what functions and capabilities the API has, how to access it and how to use it. Discover in an interactive and visual way how you can best use the API for your project.
Input
| Parameter | Type | Details |
|---|---|---|
| kvkNummer | string | Dutch KVK number. Consists of 8 digits. |
| geoData | boolean | Geodata is shown in output when the value is "True". Default value is "False". |
Output
Basisprofiel
| Parameter | Type | Details |
|---|---|---|
| kvkNummer | string | Dutch KVK number. Consists of 8 digits. |
| indNonMailing | string | The Company does not wish to receive any unsolicited mail or sales advertising. |
| naam | string | Name under societal activity. |
| formeleRegistratiedatum | string | The date the company was registered with the KVK. |
| materieleRegistratie | object | Start date and end date (when applicable) of the company. |
| statutaireNaam | string | The name of the company when articles of association are registered. |
| handelsnamen | array | All names under which a company or branch trades (in order of registration). |
| sbiActiviteiten | array | Code description of SBI activities in accordance with SBI 2008 (Standard Industrial Classification). No maximum results. See also www.kvk.nl/sbi. Array of items containing sbiCode, sbiOmschrijving, indHoofdactiviteit. |
| links | array | 1. Link to the current query 2. Link to all related branches. |
Basisprofiel - hoofdvestiging
| Parameter | Type | Details |
|---|---|---|
| vestigingsnummer | string | Branch number. Unique number consisting of 12 digits. |
| kvkNummer | string | Dutch KVK number. Consists of 8 digits. |
| rsin | string | Legal Entities Partnerships Information Number. |
| indNonMailing | string | The Company does not wish to receive any unsolicited mail or sales advertising. |
| formeleRegistratiedatum | string | The date the branch was registered with the KVK. |
| materieleRegistratie | object | Starting and end date (if applicable) of the company. |
| eersteHandelsnaam | string | The name under which a company or branch trades. |
| indHoofdvestiging | string | Main branch (Yes/No). |
| indCommercieleVestiging | string | Commercial branch (Yes/No). |
| voltijdWerkzamePersonen | integer | Number of full-time employees. |
| totaalWerkzamePersonen | integer | Total number of employees. |
| deeltijdWerkzamePersonen | integer | Number of part-time employees. |
| handelsnamen | array | All names under which a company or branch trades (in order of registration). |
| adressen | array | List of addresses. See Address table for structure. |
| websites | array | Websites registered under main branch. |
| sbiActiviteiten | array | Code description of SBI activities in accordance with SBI 2008 (Standard Industrial Classification). No maximum results. See also www.kvk.nl/sbi. Array of items containing sbiCode, sbiOmschrijving, indHoofdactiviteit. |
| links | array | 1. Link to the current query. 2. Link to all branches (based on KVK number). 3. Link to basisprofiel (based on KVK number). 4. Link to vestigingsprofiel (based on branch number). |
Basisprofiel - eigenaar
| Parameter | Type | Details |
|---|---|---|
| rsin | string | Legal Entities Partnerships Information Number. |
| rechtsvorm | string | Legal form of the organisation/company. See Possible output of legal forms. |
| uitgebreideRechtsvorm | string | Legal form supplemented with information about structure or legal capacity. See Possible output of legal forms. |
| adressen | array | Are there branches? Then "Addressen" will be displayed at the main branch. Are there no branches? Then "Addressen" will be shown under "Eigenaar". See Address table for structure. |
| websites | array | If there is no main branch, the websites will be shown here. |
| links | array | 1. Link to the current query. 2. Link to Basisprofiel (based on KVK-number). |
Basisprofiel - vestigingen
| Parameter | Type | Details |
|---|---|---|
| kvkNummer | string | Dutch KVK number. Consists of 8 digits. |
| aantalCommercieleVestigingen | integer | |
| aantalNietCommercieleVestigingen | integer | |
| totaalAantalVestigingen | integer | |
| vestigingen | array | The relevant branches. See branch table for structure. |
| links | array | 1. Link to the current query. 2. Link to Basisprofiel (based on KVK number). |
Branch
The data structure of a branch from a basisprofiel vestigingen query.
| Parameter | Type | Details |
|---|---|---|
| vestigingsnummer | string | Branch number. Unique number consisting of 12 digits. |
| eersteHandelsnaam | string | The name under which a company or establishment trades. |
| indHoofdvestiging | string | Main branch (Yes/No). |
| indCommercieleVestiging | string | Commercial branch (Yes/No). |
| volledigAdres | string | Street, house number, postal code and city. |
| links | array | 1. Link to the current query. 2. Link to Basisprofiel (based on KVK number). |
Address
The data structure of an address from a Basisprofiel hoofdvestiging or Eigenaar query.
| Parameter | Type | Details |
|---|---|---|
| type | string | Correspondence and/ or visiting address. |
| IndAfgeschermd | string | Address shielded (Yes/No). |
| volledigAdres | string | full address |
| straatnaam | string | Street name. |
| huisnummer | string | House number. |
| huisnummerToevoeging | string | House number addition. For example: 1 or A. |
| huisletter | string | House letter addition. For example: M. |
| toevoegingAdres | string | Free text to describe an address in detail. For example, when one is located in a multi-company building and there are several floors and/or rooms. |
| postcode | string | Postal code. |
| postbusnummer | integer | Mailbox number. |
| plaats | string | Town. |
| straatHuisnummer | string | Street name and house number. |
| postcodeWoonplaats | string | Postal code and Town. |
| regio | string | Region. |
| land | string | Country. |
| geoData | object | BAG ID, GPS coordinates, and national triangulation coordinates. |