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 maand.
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[] |
| 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 |
| 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
{ "_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}
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
{ "BTW": "NL852760103B01", "LEI": "724500VPC3YN0IKS8559", "RSIN": "852760103", "_links": { "self": { "href": "/openkvk/hoofdvestiging-57842019-0000-van-der-lei-techniek-bv" } }, "actief": true, "bestaandehandelsnaam": [ "Van der Lei techniek B.V." ], "dossiernummer": "57842019", "handelsnaam": "Van der Lei techniek B.V.", "huisnummer": "21", "locatie": { "lat": "52.1892035430478", "lon": "6.2135914495005" }, "pand_id": "0262100000005464", "plaats": "Gorssel", "postcode": "7213GB", "sbi": [ "64303" ], "statutairehandelsnaam": [ "Van der Lei techniek B.V." ], "straat": "Markeweg", "subdossiernummer": "0000", "type": "Hoofdvestiging", "vbo_id": "0262010000005535", "vestigingsnummer": "000027244687"}
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[] |
| 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" }, ... ]}