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

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

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