Kamer van Koophandel (KVK) Authentication

generated: '2026-11-10'
method: derived
source: openapi/kvk-nl-mutatieservice-openapi.yml
summary:
  types:
  - apiKey
  api_key_in:
  - header
schemes:
- name: ApiKeyAuth
  type: apiKey
  in: header
  parameter: apikey
  sources:
  - openapi/kvk-nl-mutatieservice-openapi.yml
credential_issuance:
  location: My Developer Portal (https://developers.kvk.nl/login), after applying at https://developers.kvk.nl/apply-for-apis
  self_serve: false
  requires: [user account, API key, paid API subscription]
  note: >-
    Real Handelsregister data needs a user account and an API key ("To use the APIs you need a user account and an API key",
    developers.kvk.nl/documentation/quickstart) under a paid API subscription (EUR 6.40/month plus per-call fees for
    Basisprofiel, Vestigingsprofiel and Naamgeving, developers.kvk.nl/pricing). The published shared test key reaches the
    test environment only, which serves a small set of fictitious companies.
environments:
- name: test
  base_url: https://api.kvk.nl/test/api
  purpose: Free test environment with a small set of fictitious data; no registration needed.
  self_service: true
  credential: shared test API key published on https://developers.kvk.nl/documentation/testing (apikey header)
  real_data: false
- name: production
  base_url: https://api.kvk.nl/api
  purpose: Live Handelsregister data.
  self_service: false
  credential: personal API key issued with a paid API subscription
  real_data: true
x-evidence:
  checked: '2026-11-11'
  probes:
  - {url: 'https://developers.kvk.nl/documentation/testing', status: 200, reading: 'test environment, "a small set of fictitious data", no registration; publishes the shared test key'}
  - {url: 'https://developers.kvk.nl/documentation/quickstart', status: 200, reading: 'production needs a user account and an API key'}
  - {url: 'https://developers.kvk.nl/pricing', status: 200, reading: 'API subscription required, EUR 6.40/month plus per-call fees'}
  - {url: 'https://api.kvk.nl/test/api/v2/zoeken?naam=test', status: 200, reading: 'JSON with the published test key'}
  - {url: 'https://api.kvk.nl/api/v2/zoeken?naam=test', status: 401, reading: 'refused with the published test key and with no key'}