Netherlands KvK → Company Markdown Profile

Turn Dutch KvK numbers, RSINs, establishment numbers or company names into clean Markdown company cards + JSON rows using the official KvK Handelsregister REST API (api.kvk.nl) with your own KvK API key.

• Official API only. Zoeken v2, Basisprofiel v1, Vestigingen and Vestigingsprofiel v1. No HTML scraping of the KvK website, no proxies, no headless browser.
• Bring your own key (BYOK). Your key is a secret input, used only as the apikey header to api.kvk.nl, never logged.
• Lightweight. 256 MB by default. A typical company takes 1–2 seconds.
• Markdown-first. Each company gets a ready-to-paste card (name, KvK, RSIN, legal form, addresses, SBI codes, status, working persons, establishments). REPORT.md holds all cards plus a summary table.
• Failures are free. A missing or invalid key (HTTP 401), an invalid number, "not found", rate limiting after retries and KvK 5xx errors are never charged.
• No contact harvesting. Email, phone, fax and website fields are dropped. Phone numbers and emails in free-text address lines are replaced with placeholders. The KvK non-mailing indicator is shown on each card.

How to get a KvK API key

Apify does not provide this key and neither does this Actor. You sign the KvK agreement yourself:

1. Open the KVK Developer Portal → Apply for APIs: https://developers.kvk.nl/apply-for-apis (docs: https://developers.kvk.nl/documentation).
2. You need a Dutch KvK registration (foreign governments excepted) and an authorised signer for the agreement. KvK reviews each request, which can take up to 7 business days.
3. KvK bills you directly: EUR 6.40 / month per key plus EUR 0.02 per Basisprofiel, Vestigingsprofiel or Naamgeving query. Zoeken is free. See https://developers.kvk.nl/pricing.
4. Paste the key into the kvkApiKey input (it is stored as a secret).

You are responsible for using KvK data under your own KvK agreement and terms of use.

Want to try it first? Turn on useKvkTestEnvironment. The Actor then queries KvK's public test environment (api.kvk.nl/test) with the test key that KvK publishes. The data is fictitious, for example KvK 68750110, 69599084, 90003942, or a name search for test. Test-environment profiles are not charged.

Input

Field	Default	Notes
kvkApiKey	—	Secret. Required for live data. Without it, KvK answers 401. Those rows are free.
kvkNumbers	—	8-digit KvK numbers. 6875 0110 and KvK: 68.75.01.10 are also accepted.
rsins	—	9-digit RSINs, resolved through the free Zoeken API.
vestigingsnummers	—	12-digit establishment numbers, resolved through Zoeken.
companyNames + searchCity	—	Official Zoeken name search (whole-word match). maxSearchResultsPerName defaults to 3.
includeBasisprofiel	true	1 paid KvK query per company. Off = light card from the free Zoeken API only.
includeEstablishments	true	1 paid KvK query per company: establishment counts and list.
includeVestigingsprofiel	false	1 paid KvK query: full-time/part-time working persons for the main (or requested) establishment.
includeInactive, includeGeoData	false	Map to the KvK inclusiefInactieveRegistraties and geoData parameters.
maxItems	50	Maximum number of successful (charged) profiles.
maxConcurrency / maxRetries	2 / 3	Retries cover 429, 5xx, timeouts and KvK IPD1002/IPD1003. 400/401/404 are never retried.

Example:

{
  "kvkApiKey": "YOUR_KVK_API_KEY",
  "kvkNumbers": ["68750110"],
  "companyNames": ["Bakkerij"],
  "searchCity": "Utrecht",
  "maxItems": 20
}

Output

Dataset: one row per company, with views Overview and Failed (not charged): kvkNumber, name, statutoryName, tradeNames[], legalForm, legalFormExtended, rsin, registrationStatus (active/inactive), registrationDate, startDate, endDate, sbiActivities[] (code, description, main), mainSbiCode, visitingAddress, postalAddress, address, city, postcode, employeesTotal, mainEstablishment, establishments (total, commercial, nonCommercial, list[]), establishmentProfile, nonMailing, kvkBillableQueries, markdown, status, errorClass, httpStatus, hint.

Key-value store: REPORT.md (table + one card per company), REPORT.json, and SUMMARY. SUMMARY includes kvkBillableQueries and kvkEstimatedCostEur, so you can reconcile with your KvK invoice.

Example card (KvK test data):

### Test BV Donald — KvK 68750110

- **Legal form:** Besloten vennootschap · RSIN `857587973`
- **Status:** **active** · registered 2017-05-19 · started 2017-05-19
- **Visiting address:** Hizzaarderlaan 3 A 8823SJ Lollum
- **Postal address:** Postbus 200 1000AE Rommeldam
- **SBI activities:** `01241` Teelt van appels en peren (main)
- **Main establishment:** `000037178598` Test BV Donald · commercial
- **Establishments:** 2 total (2 commercial, 0 non-commercial)

Pricing (pay per event)

Event	Price
Actor start	$0.001 per run
kvk-profile	$0.004 per successful company profile

Failed lookups and test-environment profiles are free. Example: 50 companies = $0.001 + 50 × $0.004 = $0.201 on Apify. KvK's own fees (EUR 0.02 per paid query) are billed to you by KvK under your agreement.

Error classes

missing_key (401, no key) · api_key_invalid (401) · forbidden (403) · invalid_input (bad number, KvK IPD0004/0006/0010) · not_found (404, IPD0005/IPD5200) · temporarily_unavailable (IPD1002/1003) · rate_limited (429) · kvk_server_error (5xx) · timeout · network. None are charged. After the first 401, the Actor stops calling KvK and marks the remaining inputs with the same error.

Not included

There are no lead lists, email/phone/website contacts, owner or director personal data, scraping of kvk.nl pages, or Mutatieservice. Use KvK's own products when you need legally certain extracts.

Source code

Open source (AGPL-3.0): https://github.com/xbox002000/netherlands-kvk-markdown