OpenKvK API documentatie

Doorzoek de dataset van openKvK.nl. De reponse bevat een lijst van bedrijven. De dataset van openKvK wordt voor nieuwe inschrijvingen en ontbindingen dagelijks bijgewerkt. Adreswijzigingen gemiddeld 1 keer per week.

API Overzicht

GET	`https://api.overheid.io/openkvk`
GET	`https://api.overheid.io/openkvk/{id}`
GET	`https://api.overheid.io/suggest/openkvk/{query}`

API endpoints

GET	`https://api.overheid.io/openkvk`

Parameters

Naam	Standaard waarde	Omschrijving
size	100	Het aantal resultaten per pagina.
page	1	De gewenste pagina van resultaten.
fields[]	handelsnaam dossiernummer subdossiernummer	Velden in het overzicht (indien aanwezig).
filters[]	Filter velden resulaten op termen. Dit is handig voor het filteren van vaste waardes, zoals bijvoorbeeld postcodes.
query		Zoek naar waarde.
queryfields	handelsnaam straat	Zoek naar waarde in deze velden.
exists		Zorg dat dit veld in de resultaten aanwezig is.

Voor de fields[] en filters[] array kun je alle veldnamen opgeven die in het details over een bedrijf aanwezig zijn.

Voorbeelden

Zoek op postcode

https://api.overheid.io/openkvk?filters[postcode]=3083cz

 1 
 2                            {
 3    "_embedded": {
 4        "bedrijf": [{
 5                "_links": {
 6                    "self": {
 7                        "href": "/openkvk/rechtspersoon-52921506-stichting-uitvaart-al-iman"
 8                    }
 9                },
10                "dossiernummer": "52921506",
11                "handelsnaam": "Stichting Uitvaart Al Iman"
12            },
13            {
14                "_links": {
15                    "self": {
16                        "href": "/openkvk/hoofdvestiging-24312396-0000-artiriaad-bv"
17                    }
18                },
19                "dossiernummer": "24312396",
20                "handelsnaam": "Artiriaad B.V.",
21                "subdossiernummer": "0000"
22            },
23            {
24                "_links": {
25                    "self": {
26                        "href": "/openkvk/hoofdvestiging-24312393-0000-artiriaad-beheer-bv"
27                    }
28                },
29                "dossiernummer": "24312393",
30                "handelsnaam": "Artiriaad Beheer B.V.",
31                "subdossiernummer": "0000"
32            },
33            ....
34        ]
35    },
36    "_links": {
37        "self": {
38            "href": "/openkvk?filters%5Bpostcode%5D=3083cz"
39        }
40    },
41    "pageCount": 1,
42    "size": 100,
43    "totalItemCount": 16
44}

Zoek naar naam met wildcards en toon extra velden (postcode & vestigingsnummer) in het overzicht.

https://api.overheid.io/openkvk?query=d*size*&fields[]=postcode&fields[]=vestigingsnummer

Je kan met de wildcard (*) zoeken. Meerdere zijn mogelijk.

 1 
 2{
 3    "_embedded": {
 4        "bedrijf": [{
 5            "_links": {
 6                "self": {
 7                    "href": "/openkvk/hoofdvestiging-58488340-0000-downsized"
 8                }
 9            },
10            "dossiernummer": "58488340",
11            "handelsnaam": "Downsized",
12            "postcode": "2716LL",
13            "subdossiernummer": "0000",
14            "vestigingsnummer": "000027825442"
15        }]
16    },
17    "_links": {
18        "self": {
19            "href": "/openkvk?query=d*size*&fields%5B%5D=postcode&fields%5B%5D=vestigingsnummer"
20        }
21    },
22    "pageCount": 1,
23    "size": 100,
24    "totalItemCount": 1
25}

Geef alle rechtspersonen terug met een postcode met letters *XD en toon de postcode in het overzicht

https://api.overheid.io/openkvk?query=*XD&queryfields[]=postcode&fields[]=postcode

 1 
 2{
 3    "_embedded": {
 4        "bedrijf": [{
 5                "_links": {
 6                    "self": {
 7                        "href": "/openkvk/hoofdvestiging-02082474-0000-hoeske-van-thais-joaptje"
 8                    }
 9                },
10                "dossiernummer": "02082474",
11                "handelsnaam": "Hoeske van Thais Joaptje",
12                "postcode": "9998XD",
13                "subdossiernummer": "0000"
14            },
15            {
16                "_links": {
17                    "self": {
18                        "href": "/openkvk/nevenvestiging-17234501-0001-proattivo-consultancy"
19                    }
20                },
21                "dossiernummer": "17234501",
22                "handelsnaam": "ProAttivo Consultancy",
23                "postcode": "1052XD",
24                "subdossiernummer": "0001"
25            },
26            {
27                "_links": {
28                    "self": {
29                        "href": "/openkvk/hoofdvestiging-58179895-0000-wonderland-industry"
30                    }
31                },
32                "dossiernummer": "58179895",
33                "handelsnaam": "Wonderland Industry",
34                "postcode": "1016XD",
35                "subdossiernummer": "0000"
36            },
37            ....
38        ]
39    },
40    "_links": {
41        "first": {
42            "href": "/openkvk?query=*XD&queryfields[0]=postcode&fields[0]=postcode&page=1"
43        },
44        "last": {
45            "href": "/openkvk?query=*XD&queryfields[0]=postcode&fields[0]=postcode&page=10"
46        },
47        "next": {
48            "href": "/openkvk?query=*XD&queryfields[0]=postcode&fields[0]=postcode&page=2"
49        },
50        "self": {
51            "href": "/openkvk?query=*XD&queryfields%5B%5D=postcode&fields%5B%5D=postcode"
52        }
53    },
54    "pageCount": 54,
55    "size": 100,
56    "totalItemCount": 5394
57}

GET	`https://api.overheid.io/openkvk/{id}`

Geef alle informatie van een bedrijf

https://api.overheid.io/openkvk/hoofdvestiging-57842019-0000-van-der-lei-techniek-bv

 1 
 2{
 3  "rechtsvormCode": "EMZ",
 4  "vestigingsnummer": "000027825442",
 5  "kvkNummer": "58488340",
 6  "activiteiten": [
 7    {
 8      "omschrijving": "Ontwikkelen, produceren en uitgeven van software",
 9      "code": "6201",
10      "hoofdactiviteit": true
11    }
12  ],
13  "vestiging": true,
14  "kvknummer": "58488340",
15  "pand_id": "0637100000178729",
16  "updated_at": "2023-04-28",
17  "actief": true,
18  "rechtsvormOmschrijving": "Eenmanszaak",
19  "activiteitomschrijving": "Ontwerp en realisatie van internet idee\u00ebn.",
20  "website": "www.downsized.nl",
21  "vbo_id": "0637010000306349",
22  "locatie": {
23    "lon": "4.47644183",
24    "lat": "52.05285837"
25  },
26  "huidigeHandelsNamen": [
27    "Downsized",
28    "overheid.io"
29  ],
30  "naam": "Downsized",
31  "bezoeklocatie": {
32    "plaats": "Zoetermeer",
33    "straat": "Bredewater",
34    "huisnummer": "16",
35    "postcode": "2715CA",
36    "land": "Nederland"
37  },
38  "non_mailing_indicatie": true,
39  "subdossiernummer": "0000",
40  "postlocatie": [],
41  "sbi": [
42    "6201"
43  ],
44  "inschrijvingstype": "Hoofdvestiging",
45  "_links": {
46    "self": {
47      "href": "\/v3\/openkvk\/hoofdvestiging-58488340-downsized"
48    }
49  }
50}

GET	`https://api.overheid.io/suggest/openkvk/{query}`

Parameters

Naam	Standaard waarde	Omschrijving
size	10	Het aantal resultaten per zoekopdracht,met en maximum van 25.
fields[]	handelsnaam dossiernummer	Velden in het overzicht.

Voorbeelden

Geeft suggesties voor de zoekterm. Handig voor autocomplete velden. De suggest houd rekening met spaties. Dus oude t geeft dezelfde resultaten als oudet

https://api.overheid.io/suggest/openkvk/12?size=5

 1 
 2{
 3    "dossiernummer": [{
 4            "dossiernummer": "12000101",
 5            "link": "/openkvk/rechtspersoon-12000101-joseph-van-de-loo-bv",
 6            "text": "12000101"
 7        },
 8        {
 9            "dossiernummer": "12000192",
10            "link": "/openkvk/rechtspersoon-12000192-ba-geurts-janssen-beheer-bv",
11            "text": "12000192"
12        }
13    ],
14    "handelsnaam": [{
15            "dossiernummer": "34160062",
16            "link": "/openkvk/rechtspersoon-34160062-120-jean-jaures-bv",
17            "text": "120 jean jaures b.v."
18        },
19        {
20            "dossiernummer": "30214676",
21            "link": "/openkvk/rechtspersoon-30214676-120-procent-bv",
22            "text": "120 procent b.v."
23        }
24    ]
25}

Geef alleen handelsnamen terug.

https://api.overheid.io/suggest/openkvk/downsi?size=10&fields[]=handelsnaam

 1 
 2{
 3    "handelsnaam": [{
 4            "dossiernummer": "17269351",
 5            "handelsnaam": "Downside Metalwork B.V.",
 6            "id": "rechtspersoon-17269351-downside-metalwork-bv",
 7            "link": "/openkvk/rechtspersoon-17269351-downside-metalwork-bv",
 8            "text": "downside"
 9        },
10        {
11            "dossiernummer": "41087295",
12            "handelsnaam": "Stichting Instuif Downside",
13            "id": "rechtspersoon-41087295-stichting-instuif-downside",
14            "link": "/openkvk/rechtspersoon-41087295-stichting-instuif-downside",
15            "plaats": "Neerkant",
16            "text": "downside"
17        },
18        {
19            "dossiernummer": "17269351",
20            "handelsnaam": "Downside Metalwork B.V.",
21            "id": "hoofdvestiging-17269351-0000-downside-metalwork-bv",
22            "link": "/openkvk/hoofdvestiging-17269351-0000-downside-metalwork-bv",
23            "plaats": "Neerkant",
24            "subdossiernummer": "0000",
25            "text": "downside"
26        },
27        ...
28    ]
29}

Zoek op dossiernummer.

https://api.overheid.io/suggest/openkvk/1002?fields[]=dossiernummer

 1 
 2{
 3    "dossiernummer": [{
 4            "dossiernummer": "10020002",
 5            "handelsnaam": "Willemsen A.G.F.",
 6            "id": "hoofdvestiging-10020002-0000-willemsen-agf",
 7            "link": "/openkvk/hoofdvestiging-10020002-0000-willemsen-agf",
 8            "plaats": "Doornenburg",
 9            "subdossiernummer": "0000",
10            "text": "10020002"
11        },
12        {
13            "dossiernummer": "10020010",
14            "handelsnaam": "Van de Graaf Schapenhouderij",
15            "id": "hoofdvestiging-10020010-0000-van-de-graaf-schapenhouderij",
16            "link": "/openkvk/hoofdvestiging-10020010-0000-van-de-graaf-schapenhouderij",
17            "plaats": "Alphen",
18            "subdossiernummer": "0000",
19            "text": "10020010"
20        },
21        {
22            "dossiernummer": "10020015",
23            "handelsnaam": "Stucadoorsbedrijf v/h W.J. Rokers en Zoon",
24            "id": "hoofdvestiging-10020015-0000-stucadoorsbedrijf-vh-wj-rokers-en-zoon",
25            "link": "/openkvk/hoofdvestiging-10020015-0000-stucadoorsbedrijf-vh-wj-rokers-en-zoon",
26            "plaats": "Wijchen",
27            "subdossiernummer": "0000",
28            "text": "10020015"
29        },
30        ...
31    ]
32}