OpenKvK V3 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/v3/openkvk`
GET	`https://api.overheid.io/v3/openkvk/{id}`
GET	`https://api.overheid.io/v3/suggest/openkvk/{query}`
GET	`https://api.overheid.io/v3/geo/openkvk/radius/{lat}/{lon}/{radius}`
GET	`https://api.overheid.io/v3/geo/openkvk/around/{id}/{radius}`
GET	`https://api.overheid.io/v3/geo/openkvk/box/{tlLat}/{tlLon}/{brLat}/{brLon}`

API endpoints

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

Parameters

Naam	Standaard waarde	Omschrijving
size	100	Het aantal resultaten per pagina.
page	1	De gewenste pagina van resultaten.
fields[]	handelsnaam kvknummer 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	huidigeHandelsNamen kvknummer	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/v3/openkvk?filters[bezoeklocatie.postcode]=2715CA

                            {
    "_embedded": {
        "bedrijf": [
          {
            "subdossiernummer": "0000",
            "naam": "KWM Karting",
            "kvknummer": "81379439",
            "_links": {
              "self": {
                "href": "\/v3\/openkvk\/hoofdvestiging-81379439-kwm-karting"
              }
            }
          },
          {
            "subdossiernummer": "0000",
            "kvknummer": "59905085",
            "naam": "Transition IT Nederland B.V.",
            "_links": {
              "self": {
                "href": "\/v3\/openkvk\/hoofdvestiging-59905085-transition-it-nederland-bv"
              }
            }
          },
          {
            "subdossiernummer": "0000",
            "naam": "Aspect Security Agency B.V.",
            "kvknummer": "86819968",
            "_links": {
              "self": {
                "href": "\/v3\/openkvk\/hoofdvestiging-86819968-aspect-security-agency-bv"
              }
            }
          },
            ....
        ]
    },
    "_links": {
        "self": {
          "href": "\/v3\/openkvk?filters[bezoeklocatie.postcode]=2715CA&page=1"
        },
        "next": {
          "href": "\/v3\/openkvk?filters[bezoeklocatie.postcode]=2715CA&page=2"
        },
        "first": {
          "href": "\/v3\/openkvk?filters[bezoeklocatie.postcode]=2715CA&page=1"
        },
        "last": {
          "href": "\/v3\/openkvk?filters[bezoeklocatie.postcode]=2715CA&page=10"
        }
      },
    "pageCount": 2,
    "size": 100,
    "totalItemCount": 175
}

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

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

{
    "_embedded": {
        "bedrijf": [
          {
        "naam": "BIzone Honthorst",
        "bezoeklocatie": {
          "postcode": "3441XD"
        },
        "kvknummer": "52013308",
        "_links": {
          "self": {
            "href": "\/v3\/openkvk\/rechtspersoon-52013308-bizone-honthorst"
          }
        }
      },
      {
        "subdossiernummer": "0000",
        "naam": "GUT AMSTERDAM B.V.",
        "bezoeklocatie": {
          "postcode": "1017XD"
        },
        "kvknummer": "88077179",
        "_links": {
          "self": {
            "href": "\/v3\/openkvk\/hoofdvestiging-88077179-gut-amsterdam-bv"
          }
        }
      },
      {
        "subdossiernummer": "0000",
        "naam": "MIA Schoonmaakbedrijf",
        "bezoeklocatie": {
          "postcode": "1058XD"
        },
        "kvknummer": "84592303",
        "_links": {
          "self": {
            "href": "\/v3\/openkvk\/hoofdvestiging-84592303-mia-schoonmaakbedrijf"
          }
        }
      },
            ....
        ]
    },
    "_links": {
        "first": {
            "href": "\/v3\/openkvk?query=*XD&queryfields[0]=bezoeklocatie.postcode&fields[0]=bezoeklocatie.postcode&page=1"
        },
        "last": {
            "href": "\/v3\/openkvk?query=*XD&queryfields[0]=bezoeklocatie.postcode&fields[0]=bezoeklocatie.postcode&page=10"
        },
        "next": {
            "href": "\/v3\/openkvk?query=*XD&queryfields[0]=bezoeklocatie.postcode&fields[0]=bezoeklocatie.postcode&page=2"
        },
        "self": {
            "href": "\/v3\/openkvk?query=*XD&queryfields%5B%5D=bezoeklocatie.postcode&fields%5B%5D=bezoeklocatie.postcode"
        }
    },
    "pageCount": 54,
    "size": 100,
    "totalItemCount": 5394
}

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

Geef alle informatie van een bedrijf

https://api.overheid.io/v3/openkvk/hoofdvestiging-58488340-downsized

{
  "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"
    }
  }
}

GET	`https://api.overheid.io/v3/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/v3/suggest/openkvk/blah

[
  {
    "link": "\/v3\/openkvk\/hoofdvestiging-89830466-blah-blah",
    "kvknummer": 89830466,
    "subdossiernummer": 0,
    "vestigingsnummer": 22844848,
    "postcode": "3054GH",
    "naam": [
      "Blah Blah"
    ]
  },
  {
    "link": "\/v3\/openkvk\/hoofdvestiging-84613777-blah-amsterdam-bv",
    "kvknummer": 84613777,
    "subdossiernummer": 0,
    "vestigingsnummer": 50723359,
    "postcode": "1013BC",
    "naam": [
      "B.L.A.H. Amsterdam B.V."
    ]
  },
  {
    "link": "\/v3\/openkvk\/rechtspersoon-84613777-blah-amsterdam-bv",
    "kvknummer": 84613777,
    "subdossiernummer": null,
    "vestigingsnummer": null,
    "postcode": null,
    "naam": [
      "B.L.A.H. Amsterdam B.V."
    ]
  },
  {
    "link": "\/v3\/openkvk\/hoofdvestiging-72792000-blahblahblahtech-bv",
    "kvknummer": 72792000,
    "subdossiernummer": 0,
    "vestigingsnummer": 40879992,
    "postcode": "1121AJ",
    "naam": [
      "BlahBlahBlah.tech B.V."
    ]
  },
  ...
]

GET	`https://api.overheid.io/v3/geo/energielabels/radius/{lat}/{lon}/{radius}`

Geef alle bedrijven om een locatie heen met een bepaalde radius in meters. De response is een GeoJSON object, zodat je die eventueel direct in kaarten kan gebruiken.

https://api.overheid.io/v3/geo/openkvk/radius/51.90465775/6.37526369/1000

Paginering, filtering etc werkt gewoon zoals in de niet geoJSON APIs die hierboven staan beschreven.

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.38595576,
          51.90775037
        ]
      },
      "properties": {
        "kvknummer": "90876202",
        "slug": "hoofdvestiging-danmazo-90876202-56572492"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.36375673,
          51.90193193
        ]
      },
      "properties": {
        "subdossiernummer": "0001",
        "kvknummer": "02062313",
        "slug": "cth-ulft-02062313-0001"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.37911293,
          51.91158474
        ]
      },
      "properties": {
        "kvknummer": "40120330",
        "slug": "vereniging-harmonie-stradboud-40120330",
        "huidigeNamen": [
          "Harmonie St.Radboud"
        ]
      }
    },
    ...
  ]
}

GET	`https://api.overheid.io/v3/geo/energielabels/around/{id}/{radius}`

Geef alle bedrijven om een bestaande bedrijf heen met een bepaalde radius in meters. De response is een GeoJSON object, zodat je die eventueel direct in kaarten kan gebruiken.

https://api.overheid.io/v3/geo/openkvk/around/nevenvestiging-stichting-humankind-41208044-26692325/1000

Gebruik voor het {id} de `slug` van het bedrijf. Filtering etc werkt gewoon zoals in de niet geoJSON APIs die hierboven staan beschreven.

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.37312264,
          51.88665524
        ]
      },
      "properties": {
        "kvknummer": "38018895",
        "slug": "nevenvestiging-administratiekantoor-blake-38018895-14828065"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.38016862,
          51.89334427
        ]
      },
      "properties": {
        "kvknummer": "91262801",
        "slug": "hoofdvestiging-beautybyjade-91262801-56948298"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.37114233,
          51.88906702
        ]
      },
      "properties": {
        "subdossiernummer": "0001",
        "kvknummer": "36039062",
        "slug": "wolters-grenen-meubelen-36039062-0001"
      }
    },
    ...
  ]
}

GET	`https://api.overheid.io/v3/geo/energielabels/box/{tlLat}/{tlLon}/{brLat}/{brLon}`

Geef alle bedrijven in een box. Je geeft daarbij de TopLeft (tlLat,tlLon) en de RightBottom (rbLat, rbLon) coördinaten mee in de request. De response is een GeoJSON object, zodat je die eventueel direct in kaarten kan gebruiken.

https://api.overheid.io/v3/geo/openkvk/box/51.91029693438848/6.38548415524967/51.90715962775278/6.3942066985473955

Filtering etc werkt gewoon zoals in de niet geoJSON APIs die hierboven staan beschreven.

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.38595576,
          51.90775037
        ]
      },
      "properties": {
        "kvknummer": "90876202",
        "slug": "hoofdvestiging-danmazo-90876202-56572492"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.39321738,
          51.90821947
        ]
      },
      "properties": {
        "kvknummer": "40123740",
        "slug": "vereniging-buurtvereniging-de-marters-40123740"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.38733492,
          51.9098387
        ]
      },
      "properties": {
        "kvknummer": "40122227",
        "slug": "vereniging-ren-en-tourclub-de-wildt-40122227",
        "huidigeNamen": [
          "Ren- en Tourclub \"De Wildt\""
        ]
      }
    },
    ...
  ]
}