Doorzoek de dataset van openKvK.nl. De reponse bevat een lijst van rechtspersonen. De dataset van openKvK wordt op dit moment ongeveer 1x per maand bijgewerkt.

API Overzicht

GEThttp://overheid.io/api/kvk
GEThttps://overheid.io/api/kvk/{dossier-nummer}/{subdossier-nummer}
GEThttps://overheid.io/suggest/kvk/{query}

API endpoints

GEThttp://overheid.io/api/kvk

Parameters

Naam Standaard waarde Omschrijving
size100Het aantal resultaten per pagina.
page1De gewenste pagina van resultaten.
sortsorteer veld.
orderdescsorteer richting.
fields[]
  • handelsnaam
  • dossiernummer
  • subdossiernummer
Velden in het overzicht.
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.

Voorbeelden

Zoek op postcode
https://overheid.io/api/kvk?filters[postcode]=3083cz
{
    "totalItemCount": 21,
    "pageCount": 1,
    "size": 100,
    "_links": {"self": {"href": "/api/kvk?filters[postcode]=3083cz"}},
    "_embedded": {"rechtspersoon": [
        {
            "dossiernummer": "24438695",
            "handelsnaam": "Kamer van Koophandel Rotterdam, Ondernemershuis Zuid",
            "subdossiernummer": "0003",
            "_links": {"self": {"href": "/api/kvk/24438695/0003"}}
        },
        {
            "dossiernummer": "24438695",
            "handelsnaam": "Kamer van Koophandel en Fabrieken voor Rotterdam, Ondernemershuis Zuid",
            "subdossiernummer": "0004",
            "_links": {"self": {"href": "/api/kvk/24438695/0004"}}
        },
        ....
    ]}
}
            
Zoek naar naam met wildcards en toon extra velden (postcode & vestigingsnummer) in het overzicht.
https://overheid.io/api/kvk?query=d*size*&fields[]=postcode&fields[]=vestigingsnummer

Je kan met de wildcard (*) zoeken. Meerdere zijn mogelijk.

{
    "totalItemCount": 4,
    "pageCount": 1,
    "size": 100,
    "_links": {"self": {"href": "/api/kvk?query=d*size*&fields[]=postcode&fields[]=vestigingsnummer"}},
    "_embedded": {"rechtspersoon": [
        {
            "dossiernummer": "58488340",
            "handelsnaam": "Downsized",
            "postcode": "2717XD",
            "subdossiernummer": "0000",
            "vestigingsnummer": "27825442",
            "_links": {"self": {"href": "/api/kvk/58488340/0000"}}
        },
        ....
    ]}
}
            
Geef alle rechtspersonen terug met een postcode met letters *XD en toon de postcode in het overzicht
https://overheid.io/api/kvk?query=*XD&queryfields[]=postcode&fields[]=postcode
{
    "totalItemCount": 6510,
    "pageCount": 66,
    "size": 100,
    "_links": {
        "self": {"href": "/api/kvk?query=*XD&queryfields[]=postcode&fields[]=postcode"},
        "next": {"href": "/api/kvk?query=*XD&queryfields[]=postcode&fields[]=postcode?query=*XD&queryfields[0]=postcode&fields[0]=postcode&page=2"},
        "first": {"href": "/api/kvk?query=*XD&queryfields[]=postcode&fields[]=postcode?query=*XD&queryfields[0]=postcode&fields[0]=postcode&page=1"},
        "last": {"href": "/api/kvk?query=*XD&queryfields[]=postcode&fields[]=postcode?query=*XD&queryfields[0]=postcode&fields[0]=postcode&page=66"}
    },
    "_embedded": {"rechtspersoon": [
        {
            "dossiernummer": "58488340",
            "handelsnaam": "Downsized",
            "postcode": "2717XD",
            "subdossiernummer": "0000",
            "_links": {"self": {"href": "/api/kvk/58488340/0000"}}
        },
        ...
    ]}
}
            

GEThttps://overheid.io/api/kvk/{dossier-nummer}/{subdossier-nummer}
Geef alle informatie van een rechtspersoon
https://overheid.io/api/kvk/58488340/0000
{
    "actief": true,
    "bestaandehandelsnaam": "Downsized",
    "dossiernummer": "58488340",
    "handelsnaam": "Downsized",
    "huisnummer": "81",
    "huisnummertoevoeging": "",
    "plaats": "Zoetermeer",
    "postcode": "2717XD",
    "straat": "Anna Blamanhove",
    "subdossiernummer": "0000",
    "type": "Hoofdvestiging",
    "vestigingsnummer": 27825442,
    "_links": {"self": {"href": "/api/kvk/58488340/0000"}}
}
            

GEThttps://overheid.io/suggest/kvk/{query}

Parameters

Naam Standaard waarde Omschrijving
size10Het aantal resultaten per zoekopdracht,met en maximum van 25.
fields[]
  • handelsnaam
  • straat
  • 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://overheid.io/suggest/kvk/oudet?size=5
{
    "handelsnaam": [
        {
            "text": "Oude Tijdhof Optiek B.V.",
            "extra": {"id": "05076440/0000"}
        },
        {
            "text": "Oude Tol Groenprojecten",
            "extra": {"id": "22063560/0000"}
        },
        {
            "text": "Oude Toren Beheer B.V.",
            "extra": {"id": "17073018/0000"}
        },
        {
            "text": "Oude Toren Consultancy",
            "extra": {"id": "57244359/0000"}
        },
        {
            "text": "Oude Trekker Club Albergen en Omstreken",
            "extra": {"id": "08138217/0000"}
        }
    ],
    "straat": [
        {
            "text": "OUDE TELGTERWEG",
            "extra": {"postcode": "3851EE"}
        },
        {
            "text": "Oude Telgterweg",
            "extra": {"postcode": "3851LT"}
        },
        {
            "text": "OUDE TRAMBAAN",
            "extra": {"postcode": "6093CE"}
        },
        {
            "text": "Oude Trambaan",
            "extra": {"postcode": "2265DA"}
        },
        {
            "text": "Oude Terborgseweg",
            "extra": {"postcode": "7004GZ"}
        }
    ]
}
            
Geef alleen handelsnamen terug.
https://overheid.io/suggest/kvk/downsi?size=10&fields[]=handelsnaam
{"handelsnaam": [
    {
        "text": "Down Side Up",
        "extra": {"id": "08118078/0000"}
    },
    {
        "text": "DownSideUp",
        "extra": {"id": "56850042/0000"}
    },
    {
        "text": "Downside Metalwork B.V.",
        "extra": {"id": "17269351/0000"}
    },
    {
        "text": "Downside Music Productions",
        "extra": {"id": "17135500/0000"}
    },
    {
        "text": "Downside Tuning",
        "extra": {"id": "60687797/0000"}
    },
    {
        "text": "Downsized",
        "extra": {"id": "58488340/0000"}
    },
    {
        "text": "Laurens training & coaching",
        "extra": {"id": "55821871/0000"}
    },
    {
        "text": "Stichting Instuif Downside",
        "extra": {"id": "41087295/0000"}
    }
]}
            
Zoek op dossiernummer.
https://overheid.io/suggest/kvk/1002?fields[]=dossiernummer
{"dossiernummer": [
    {
        "text": "1002411",
        "extra": {
            "id": "1002411/0069",
            "handelsnaam": "Friesland Bank"
        }
    },
    {
        "text": "10028412",
        "extra": {
            "id": "10028412/0051",
            "handelsnaam": "Bakker Bart"
        }
    },
    {
        "text": "10020283",
        "extra": {
            "id": "10020283/0009",
            "handelsnaam": "ARNHEMSE KOERIER"
        }
    },
    {
        "text": "10028607",
        "extra": {
            "id": "10028607/0001",
            "handelsnaam": "Pijco Nijmegen B.V."
        }
    },
    {
        "text": "1002486",
        "extra": {
            "id": "1002486/0004",
            "handelsnaam": "Coöperatieve Rabobank Leeuwarden-Noordwest Friesland U.A."
        }
    },
    {
        "text": "10027052",
        "extra": {
            "id": "10027052/0000",
            "handelsnaam": "Vermeulen Verzekeringen Vastgoed"
        }
    },
    {
        "text": "10023205",
        "extra": {
            "id": "10023205/0000",
            "handelsnaam": "Van Bon Cold Stores B.V."
        }
    },
    {
        "text": "10024068",
        "extra": {
            "id": "10024068/0000",
            "handelsnaam": "Roggeweg B.V."
        }
    },
    {
        "text": "10021177",
        "extra": {
            "id": "10021177/0004",
            "handelsnaam": "GUIJT ADVIESGROEP"
        }
    },
    {
        "text": "10025287",
        "extra": {
            "id": "10025287/0034",
            "handelsnaam": "Van Neerbos bouwmaterialen groep"
        }
    }
]}