{"id":"fe1ac0fe-955e-42db-92eb-2f4639117b25","slug":"kvk-nl-api","name":"kvk.nl API","description":"kvk.nl API","front_facing_description":"Search for Dutch businesses and retrieve detailed company information such as registration numbers, addresses, and business details directly from the official KVK trade register. Look up specific companies to access their official registration data and verify business information in the Netherlands.","source_url":"https://kvk.nl","is_authenticated":false,"canonical_scraper_id":"9c941901-c954-4478-97b5-179954ecdf2b","apis":[{"method":"GET","endpoint_name":"search_businesses","description":"Full-text search across the KVK Handelsregister (Dutch trade register). Matches business names, KVK numbers, addresses, and keywords. Returns paginated results filtered to currently registered (ingeschreven) businesses. Each result includes registration details, legal form, address, and activity description.","input_params":{"page":{"type":"integer","required":false,"description":"Page number for pagination (1-based).","default":1,"domain":{"kind":"open","example":"1","generator":{"type":"static","value":"1"}}},"query":{"type":"string","required":true,"description":"Search term: business name, KVK number, address, or keyword.","domain":{"kind":"open","example":"bakker amsterdam","generator":{"type":"static","value":"bakker amsterdam"}}},"page_size":{"type":"integer","required":false,"description":"Number of results per page (1-50).","default":10,"domain":{"kind":"open","example":"10","generator":{"type":"static","value":"10"}}}},"return_schema":{"type":"object","fields":{"page":"current page number","items":"array of business registration entries","total":"total number of matching results","page_size":"results per page"},"sample":{"data":{"page":1,"items":[{"naam":"Bakker Renovaties Amsterdam","actief":true,"kvk_nummer":"52185532","rechtsvorm":"Eenmanszaak","postlocatie":null,"handelsnamen":["Bakker Renovaties Amsterdam"],"bezoeklocatie":{"plaats":"Zwanenburg","straat":"Populierenlaan","postcode":"1161SR","huisnummer":"76"},"rechtsvorm_code":"EMZ","vestigingsnummer":"000022142878","inschrijvingstype":"Hoofdvestiging","inschrijvingsdatum":"2011-03-01","activiteitomschrijving":"Timmer- en tegelzetwerken. Elektra- en cv-installateur."}],"total":305,"page_size":10},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.items","op":"array_min_len","value":1},{"path":"$.data.items[*]","op":"field_present","value":"kvk_nummer"},{"path":"$.data.items[*]","op":"field_present","value":"naam"},{"path":"$.data.total","op":"not_null","value":true}],"empty_is_valid":true,"recipe_version":1}},{"method":"GET","endpoint_name":"get_business","description":"Look up a specific business by its KVK number. Returns all registration entries (vestigingen and rechtspersoon) associated with that number. A business may have multiple entries when it has branch offices.","input_params":{"kvk_nummer":{"type":"string","required":true,"description":"8-digit KVK registration number (e.g. 52185532).","domain":{"kind":"open","example":"52185532","pattern":"^\\d{8}$","generator":{"type":"static","value":"52185532"}}}},"return_schema":{"type":"object","fields":{"total":"number of entries found","entries":"array of registration entries for this KVK number"},"sample":{"data":{"total":1,"entries":[{"naam":"Bakker Renovaties Amsterdam","actief":true,"kvk_nummer":"52185532","rechtsvorm":"Eenmanszaak","postlocatie":null,"handelsnamen":["Bakker Renovaties Amsterdam"],"bezoeklocatie":{"plaats":"Zwanenburg","straat":"Populierenlaan","postcode":"1161SR","huisnummer":"76"},"rechtsvorm_code":"EMZ","statutaire_naam":null,"vestigingsnummer":"000022142878","inschrijvingstype":"Hoofdvestiging","inschrijvingsdatum":"2011-03-01","activiteitomschrijving":"Timmer- en tegelzetwerken. Elektra- en cv-installateur."}]},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.entries","op":"array_min_len","value":1},{"path":"$.data.entries[*]","op":"field_present","value":"kvk_nummer"},{"path":"$.data.entries[*]","op":"field_present","value":"naam"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_business_details","description":"Look up enriched company details by KVK number. Returns all registration entries (vestigingen) with SBI activity codes, industry descriptions, trade names (current and historical), and core registration fields. Employee range (personeelsklasse) is included in the response structure but is null for publicly accessible data (requires authenticated access via KVK Bedrijvencheck). A business may have multiple entries when it has branch offices.","input_params":{"kvk_nummer":{"type":"string","required":true,"description":"8-digit KVK registration number (e.g. 33031431).","domain":{"kind":"open","example":"33031431","pattern":"^\\d{8}$","generator":{"type":"static","value":"33031431"}}}},"return_schema":{"type":"object","fields":{"total":"number of entries found for this KVK number","entries":"array of enriched registration entries including SBI activity codes"},"sample":{"data":{"total":1,"entries":[{"naam":"Bakker Renovaties Amsterdam","actief":true,"kvk_nummer":"52185532","rechtsvorm":"Eenmanszaak","postlocatie":null,"handelsnamen":["Bakker Renovaties Amsterdam"],"bezoeklocatie":{"plaats":"Zwanenburg","straat":"Populierenlaan","postcode":"1161SR","huisnummer":"76"},"rechtsvorm_code":"EMZ","statutaire_naam":null,"personeelsklasse":null,"sbi_activiteiten":[{"sbi_code":"41000","omschrijving":"Burgerlijke en utiliteitsbouw","is_hoofdactiviteit":true}],"vestigingsnummer":"000022142878","inschrijvingstype":"Hoofdvestiging","oude_handelsnamen":[],"inschrijvingsdatum":"2011-03-01","activiteitomschrijving":"Timmer- en tegelzetwerken. Elektra- en cv-installateur."}]},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.entries","op":"array_min_len","value":1},{"path":"$.data.entries[*]","op":"field_present","value":"kvk_nummer"},{"path":"$.data.entries[*]","op":"field_present","value":"sbi_activiteiten"},{"path":"$.data.entries[*]","op":"field_present","value":"naam"}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"get_business":{"kvk_nummer":"52185532"},"search_businesses":{"page":"1","query":"bakker amsterdam","page_size":"10"},"get_business_details":{"kvk_nummer":"33031431"}},"prefill_inputs":{"search_businesses":{"page":"1","query":"bakker amsterdam","page_size":"10"},"get_business":{"kvk_nummer":"52185532"},"get_business_details":{"kvk_nummer":"33031431"}},"last_verified_at":"2026-10-30T13:37:50.065797+00:00","endpoint_health":[{"endpoint_name":"get_business","status":"healthy","last_checked_at":"2026-10-30T02:04:25.420873+00:00","last_verified_at":"2026-10-30T02:04:25.420873+00:00","recent_runs":[{"at":"2026-10-30T02:04:25.420873+00:00","status":"healthy"},{"at":"2026-10-23T01:02:25.205027+00:00","status":"healthy"},{"at":"2026-10-16T00:00:53.278493+00:00","status":"healthy"},{"at":"2026-10-09T00:00:52.930341+00:00","status":"healthy"},{"at":"2026-10-01T22:03:53.060147+00:00","status":"healthy"}]},{"endpoint_name":"search_businesses","status":"healthy","last_checked_at":"2026-10-30T13:37:50.065797+00:00","last_verified_at":"2026-10-30T13:37:50.065797+00:00","recent_runs":[{"at":"2026-10-30T02:04:25.420873+00:00","status":"healthy"},{"at":"2026-10-23T01:02:25.205027+00:00","status":"healthy"},{"at":"2026-10-16T00:00:53.278493+00:00","status":"healthy"},{"at":"2026-10-09T00:00:52.930341+00:00","status":"healthy"},{"at":"2026-10-01T22:03:53.060147+00:00","status":"healthy"}]},{"endpoint_name":"get_business_details","status":"healthy","last_checked_at":"2026-10-30T02:04:25.420873+00:00","last_verified_at":"2026-10-30T02:04:25.420873+00:00","recent_runs":[{"at":"2026-10-30T02:04:25.420873+00:00","status":"healthy"},{"at":"2026-10-23T01:02:25.205027+00:00","status":"healthy"},{"at":"2026-10-16T00:00:53.278493+00:00","status":"healthy"},{"at":"2026-10-09T00:00:52.930341+00:00","status":"healthy"},{"at":"2026-10-01T22:03:53.060147+00:00","status":"healthy"}]}],"sdk_usage_example":null,"sdk_delivery_state":"absent","summary":"Search and look up businesses registered in the Dutch Chamber of Commerce (KVK) trade register.","updated_at":"2026-08-27T17:33:31.939772+00:00","user_variants":[],"latest_version":3,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"Yes. KVK provides an official API called the KVK API, documented at developer.kvk.nl. It requires registration and approval. This Parse API offers an alternative that does not require a separate KVK developer account.","q":"Does KVK offer an official developer API?"},{"a":"`get_business_details` adds SBI activity codes with industry descriptions, the `personeelsklasse` (employee range band), and both current and historical trade names. `get_business` returns the base registration entries — legal form, address, and branch structure — without those enrichment fields.","q":"What does `get_business_details` return that `get_business` does not?"},{"a":"Not currently. All three endpoints are filtered to active, currently registered businesses. Dissolved or deregistered entities are not returned. You can fork this API on Parse and revise it to add an endpoint targeting historical or deregistered records if your use case requires that coverage.","q":"Can I retrieve data for deregistered or dissolved Dutch businesses?"},{"a":"No — the KVK Handelsregister covers only entities registered in the Netherlands. Foreign companies without a Dutch registration are not included in any endpoint's results.","q":"Does the search endpoint return results for businesses outside the Netherlands?"},{"a":"Not currently. The API returns registration fields — KVK number, legal form, address, SBI codes, trade names, and employee band — but does not expose phone numbers or email addresses. You can fork this API on Parse and revise it to add an endpoint that retrieves contact details if that data becomes accessible.","q":"Is contact information such as phone numbers or email addresses available in the response?"}],"keywords":["KVK API","Dutch Chamber of Commerce API","Handelsregister API","Netherlands business registration API","KVK number lookup","SBI code Netherlands","Dutch company search API","KVK vestigingen data","Netherlands trade register API","verify Dutch business KVK","Dutch legal entity data API","KVK rechtspersoon lookup","Netherlands company enrichment API","personeelsklasse Netherlands API","Dutch B2B data API"],"use_cases":["Verify a Dutch supplier's legal status and registered address using their KVK number before onboarding","Classify Netherlands-based companies by industry sector using SBI codes returned by `get_business_details`","Build a B2B prospecting list by running keyword searches with `search_businesses` and collecting registration data","Identify all branch offices of a company by checking the multiple `vestigingen` entries returned by `get_business`","Validate that a KVK number corresponds to an active business before processing a payment or contract","Enrich a CRM with official trade names, including historical aliases, sourced from `get_business_details`","Segment Dutch business contacts by employee band using the `personeelsklasse` field"],"meta_title":"KVK.nl API – Dutch Chamber of Commerce Data","generated_at":"2026-08-27T17:33:58.254693+00:00","lead_paragraph":"The KVK.nl API provides access to the Dutch Chamber of Commerce (Kamer van Koophandel) trade register through 3 endpoints. Use `search_businesses` to run full-text queries across business names, KVK numbers, and addresses, or call `get_business_details` to retrieve SBI industry codes, employee range (personeelsklasse), trade names, and branch office records for any 8-digit KVK number.","schema_version":2,"meta_description":"Search and retrieve Dutch business registrations from the KVK Handelsregister. Access KVK numbers, SBI codes, addresses, legal forms, and trade names via 3 endpoints.","primary_category":"b2b_directory","long_description_md":"## What the API covers\n\nThe KVK Handelsregister is the official source of record for all businesses and legal entities registered in the Netherlands. This API exposes three endpoints covering search and lookup: `search_businesses` for paginated full-text queries, `get_business` for fetching all registration entries tied to a KVK number, and `get_business_details` for enriched records including SBI activity codes and trade name history.\n\n## Endpoint details\n\n`search_businesses` accepts a `query` string (business name, KVK number, address, or keyword) and returns a paginated list with `total`, `page`, `page_size`, and an `items` array of registration entries. Page size is configurable from 1 to 50. Results are filtered to currently registered (`ingeschreven`) businesses only — dissolved entities are not included.\n\n`get_business` takes an 8-digit `kvk_nummer` and returns all associated entries, covering both branch offices (`vestigingen`) and legal entities (`rechtspersoon`). The `total` field tells you how many entries the KVK number maps to, which is useful when a company operates multiple locations under a single registration.\n\n`get_business_details` returns enriched records for a given `kvk_nummer`, adding SBI codes with industry descriptions, historical and current trade names, and the `personeelsklasse` (employee band) field. This endpoint is the right choice when you need to classify a business by sector or verify its trading identity beyond the base registration fields.\n\n## Coverage and limitations\n\nAll three endpoints cover currently registered Dutch businesses. The `search_businesses` endpoint returns only active registrations; there is no parameter to include deregistered businesses. SBI codes and employee range are available through `get_business_details` but are not present in the base `search_businesses` results. Pagination in `search_businesses` is 1-based, with a maximum of 50 results per page.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["government_public","maps_geo"]},"primary_category":"b2b_directory","secondary_categories":["government_public","maps_geo"],"access_requirements":[]}