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

GEThttps://api.overheid.io/openkvk
GEThttps://api.overheid.io/openkvk/{id}
GEThttps://api.overheid.io/suggest/openkvk/{query}

API endpoints

GEThttps://api.overheid.io/openkvk

Parameters

Naam Standaard waarde Omschrijving
size100Het aantal resultaten per pagina.
page1De 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.
queryZoek naar waarde.
queryfields
  • handelsnaam
  • straat
Zoek naar waarde in deze velden.
exists
Zorg dat dit veld in de resultaten aanwezig is.

Voorbeelden

Zoek op postcode
https://api.overheid.io/openkvk?filters[postcode]=3083cz
{
"_embedded": {
"bedrijf": [{
"_links": {
"self": {
"href": "/openkvk/rechtspersoon-52921506-stichting-uitvaart-al-iman"
}
},
"dossiernummer": "52921506",
"handelsnaam": "Stichting Uitvaart Al Iman"
},
{
"_links": {
"self": {
"href": "/openkvk/hoofdvestiging-24312396-0000-artiriaad-bv"
}
},
"dossiernummer": "24312396",
"handelsnaam": "Artiriaad B.V.",
"subdossiernummer": "0000"
},
{
"_links": {
"self": {
"href": "/openkvk/hoofdvestiging-24312393-0000-artiriaad-beheer-bv"
}
},
"dossiernummer": "24312393",
"handelsnaam": "Artiriaad Beheer B.V.",
"subdossiernummer": "0000"
},
....
]
},
"_links": {
"self": {
"href": "/openkvk?filters%5Bpostcode%5D=3083cz"
}
},
"pageCount": 1,
"size": 100,
"totalItemCount": 16
}
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.

{
"_embedded": {
"bedrijf": [{
"_links": {
"self": {
"href": "/openkvk/hoofdvestiging-58488340-0000-downsized"
}
},
"dossiernummer": "58488340",
"handelsnaam": "Downsized",
"postcode": "2716LL",
"subdossiernummer": "0000",
"vestigingsnummer": "000027825442"
}]
},
"_links": {
"self": {
"href": "/openkvk?query=d*size*&fields%5B%5D=postcode&fields%5B%5D=vestigingsnummer"
}
},
"pageCount": 1,
"size": 100,
"totalItemCount": 1
}
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
{
"_embedded": {
"bedrijf": [{
"_links": {
"self": {
"href": "/openkvk/hoofdvestiging-02082474-0000-hoeske-van-thais-joaptje"
}
},
"dossiernummer": "02082474",
"handelsnaam": "Hoeske van Thais Joaptje",
"postcode": "9998XD",
"subdossiernummer": "0000"
},
{
"_links": {
"self": {
"href": "/openkvk/nevenvestiging-17234501-0001-proattivo-consultancy"
}
},
"dossiernummer": "17234501",
"handelsnaam": "ProAttivo Consultancy",
"postcode": "1052XD",
"subdossiernummer": "0001"
},
{
"_links": {
"self": {
"href": "/openkvk/hoofdvestiging-58179895-0000-wonderland-industry"
}
},
"dossiernummer": "58179895",
"handelsnaam": "Wonderland Industry",
"postcode": "1016XD",
"subdossiernummer": "0000"
},
....
]
},
"_links": {
"first": {
"href": "/openkvk?query=*XD&queryfields[0]=postcode&fields[0]=postcode&page=1"
},
"last": {
"href": "/openkvk?query=*XD&queryfields[0]=postcode&fields[0]=postcode&page=10"
},
"next": {
"href": "/openkvk?query=*XD&queryfields[0]=postcode&fields[0]=postcode&page=2"
},
"self": {
"href": "/openkvk?query=*XD&queryfields%5B%5D=postcode&fields%5B%5D=postcode"
}
},
"pageCount": 54,
"size": 100,
"totalItemCount": 5394
}

GEThttps://api.overheid.io/openkvk/{id}
Geef alle informatie van een bedrijf
https://api.overheid.io/openkvk/hoofdvestiging-57842019-0000-van-der-lei-techniek-bv
{
"rechtsvormCode": "EMZ",
"vestigingsnummer": "000027825442",
"kvkNummer": "58488340",
"activiteiten": [
{
"omschrijving": "Ontwikkelen, produceren en uitgeven van software",
"code": "6201",
"hoofdactiviteit": true
}
],
"vestiging": true,
"kvknummer": "58488340",
"pand_id": "0637100000178729",
"updated_at": "2023-04-28",
"actief": true,
"rechtsvormOmschrijving": "Eenmanszaak",
"activiteitomschrijving": "Ontwerp en realisatie van internet idee\u00ebn.",
"website": "www.downsized.nl",
"vbo_id": "0637010000306349",
"locatie": {
"lon": "4.47644183",
"lat": "52.05285837"
},
"huidigeHandelsNamen": [
"Downsized",
"overheid.io"
],
"naam": "Downsized",
"bezoeklocatie": {
"plaats": "Zoetermeer",
"straat": "Bredewater",
"huisnummer": "16",
"postcode": "2715CA",
"land": "Nederland"
},
"non_mailing_indicatie": true,
"subdossiernummer": "0000",
"postlocatie": [],
"sbi": [
"6201"
],
"inschrijvingstype": "Hoofdvestiging",
"_links": {
"self": {
"href": "\/v3\/openkvk\/hoofdvestiging-58488340-downsized"
}
}
}

GEThttps://api.overheid.io/suggest/openkvk/{query}

Parameters

Naam Standaard waarde Omschrijving
size10Het 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
{
"dossiernummer": [{
"dossiernummer": "12000101",
"link": "/openkvk/rechtspersoon-12000101-joseph-van-de-loo-bv",
"text": "12000101"
},
{
"dossiernummer": "12000192",
"link": "/openkvk/rechtspersoon-12000192-ba-geurts-janssen-beheer-bv",
"text": "12000192"
}
],
"handelsnaam": [{
"dossiernummer": "34160062",
"link": "/openkvk/rechtspersoon-34160062-120-jean-jaures-bv",
"text": "120 jean jaures b.v."
},
{
"dossiernummer": "30214676",
"link": "/openkvk/rechtspersoon-30214676-120-procent-bv",
"text": "120 procent b.v."
}
]
}
Geef alleen handelsnamen terug.
https://api.overheid.io/suggest/openkvk/downsi?size=10&fields[]=handelsnaam
{
"handelsnaam": [{
"dossiernummer": "17269351",
"handelsnaam": "Downside Metalwork B.V.",
"id": "rechtspersoon-17269351-downside-metalwork-bv",
"link": "/openkvk/rechtspersoon-17269351-downside-metalwork-bv",
"text": "downside"
},
{
"dossiernummer": "41087295",
"handelsnaam": "Stichting Instuif Downside",
"id": "rechtspersoon-41087295-stichting-instuif-downside",
"link": "/openkvk/rechtspersoon-41087295-stichting-instuif-downside",
"plaats": "Neerkant",
"text": "downside"
},
{
"dossiernummer": "17269351",
"handelsnaam": "Downside Metalwork B.V.",
"id": "hoofdvestiging-17269351-0000-downside-metalwork-bv",
"link": "/openkvk/hoofdvestiging-17269351-0000-downside-metalwork-bv",
"plaats": "Neerkant",
"subdossiernummer": "0000",
"text": "downside"
},
...
]
}
Zoek op dossiernummer.
https://api.overheid.io/suggest/openkvk/1002?fields[]=dossiernummer
{
"dossiernummer": [{
"dossiernummer": "10020002",
"handelsnaam": "Willemsen A.G.F.",
"id": "hoofdvestiging-10020002-0000-willemsen-agf",
"link": "/openkvk/hoofdvestiging-10020002-0000-willemsen-agf",
"plaats": "Doornenburg",
"subdossiernummer": "0000",
"text": "10020002"
},
{
"dossiernummer": "10020010",
"handelsnaam": "Van de Graaf Schapenhouderij",
"id": "hoofdvestiging-10020010-0000-van-de-graaf-schapenhouderij",
"link": "/openkvk/hoofdvestiging-10020010-0000-van-de-graaf-schapenhouderij",
"plaats": "Alphen",
"subdossiernummer": "0000",
"text": "10020010"
},
{
"dossiernummer": "10020015",
"handelsnaam": "Stucadoorsbedrijf v/h W.J. Rokers en Zoon",
"id": "hoofdvestiging-10020015-0000-stucadoorsbedrijf-vh-wj-rokers-en-zoon",
"link": "/openkvk/hoofdvestiging-10020015-0000-stucadoorsbedrijf-vh-wj-rokers-en-zoon",
"plaats": "Wijchen",
"subdossiernummer": "0000",
"text": "10020015"
},
...
]
}