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}`

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."
    ]
  },
  ...
]