Overheid.io KVK

⚡ Built-in — Data & Enrichment

Search the Dutch Chamber of Commerce (KVK) registry via overheid.io. Find companies by location, industry (SBI), legal form, and size. Returns normalized, clean data.

⚡ Built-in — No Setup Required This integration is built into the WebsitePublisher platform. All endpoints are available immediately — no API key needed.

Endpoints (3)

POST search

Search for Dutch companies in the KVK registry. Supports location (postcode range, place name, or radius), SBI industry codes, legal form, and company size filters. Returns normalized data with cleaned rechtsvorm codes.

Field	Type	Required	Description
`locatie_modus`	string	✓ Yes	Location filter mode: "postcode" (range), "plaats" (city name), or "straal" (radius around address). One of these is required.
`postcode_van`	string	No	Start of postcode range (4 digits, e.g. "2500"). Supports wildcards: "25" matches all 25xx. Only used with locatie_modus=postcode.
`postcode_tot`	string	No	End of postcode range (4 digits). Only used with locatie_modus=postcode.
`plaatsen`	array	No	Array of city/place names. Aliases handled automatically (Den Haag → 's-Gravenhage). Only used with locatie_modus=plaats.
`straal_adres`	string	No	Address for radius search (will be geocoded). Only used with locatie_modus=straal.
`straal_km`	integer	No	Radius in kilometers (1, 2, 5, 10, 25, 50). Only used with locatie_modus=straal.
`sbi_codes`	array	No	Array of SBI industry codes (e.g. ["62010", "7022"]). The API will probe granularity automatically (5→4→3→2 digit fallback).
`rechtsvormen`	array	No	Array of legal form codes: BV, NV, EMZ, VOF, CV, MTS, STI, VER, KVE, OWM, PRR, KKG, BUI. Empty = all.
`wp_min`	integer	No	Minimum number of employees (werkzame personen).
`wp_max`	integer	No	Maximum number of employees.
`toon_onbekende_grootte`	boolean	No	Include companies with unknown employee count (NULL). Default: true. Many small BVs and holdings have no employee data.
`alleen_hoofdvestiging`	boolean	No	Only show main establishments. Default: true. Note: government/non-profit often has inconsistent data here.
`alleen_actief`	boolean	No	Only show active companies. Default: true. Note: NULL "actief" values are excluded by the API when this is true.
`page`	integer	No	Page number (1-based). Default: 1. Max 100 results per page.
`size`	integer	No	Results per page. Default: 100. Max: 100.

GET detail

Get full details for a single company by vestigingsnummer (KVK establishment number).

Field	Type	Required	Description
`vestigingsnummer`	string	✓ Yes	The 12-digit KVK vestigingsnummer.

POST count

Quick count of companies matching the given filters. Same filters as search, but only returns the total count. Used for live counter in search UI.

Field	Type	Required	Description
`locatie_modus`	string	✓ Yes	Same as search endpoint.
`postcode_van`	string	No
`postcode_tot`	string	No
`plaatsen`	array	No
`sbi_codes`	array	No
`rechtsvormen`	array	No
`wp_min`	integer	No
`wp_max`	integer	No
`alleen_hoofdvestiging`	boolean	No
`alleen_actief`	boolean	No

MCP Tool Names

When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:

Endpoint	MCP Tool Name
search	`overheid-io_search`
detail	`overheid-io_detail`
count	`overheid-io_count`

← Back to all integrations