---
title: "KvK Lookup"
space: "ERPNext"
url: "https://www.prilk.com/docs/erpnext/localization/netherlands/kvk-lookup"
updated: "2026-05-15"
---

# KvK Lookup

Every Dutch business has a *KvK-nummer* — the 8-digit registration number
assigned by the Kamer van Koophandel (KvK, the Dutch Chamber of Commerce).
This module adds a one-click lookup that fetches the company's official
details from the KvK registry and populates your Customer or Supplier
record.

## What gets filled

Click **Lookup KvK** on a Customer or Supplier form after entering the
KvK number, and you'll get:

- Legal company name (*statutaire naam*)
- Trading name if different
- Registered address (street, postcode, city)
- Activity classification (SBI-code)
- Founding date and legal form (BV, eenmanszaak, VOF, etc.)
- Status (active / dissolved / suspended)

These are written to the corresponding ERPNext fields plus the Customer's
or Supplier's primary Address.

## Search by name

Don't have the KvK number? Click **Search KvK** instead and type a partial
company name. The dialog shows matching companies; pick one and the form
fills in everything including the KvK number.

## Configuration

KvK lookup uses the [overheid.io OpenKvK API](https://overheid.io/), which
resells the official KvK data feed. You need an API key:

1. Sign up at [overheid.io](https://overheid.io/). Free tier returns test
   data only.
2. Open **Netherlands Localization Settings** in ERPNext.
3. Tick **Enable KvK Lookup** and paste the API key into the password
   field. Save.

## Pricing

overheid.io charges per lookup tier. As of 2026 the Small plan is around
**€150/year** for 2,500 lookups/month — sufficient for most SMBs that
onboard a few new B2B customers per week. Heavier usage requires a higher
tier; check overheid.io for current pricing.

## Limitations

- **Dutch businesses only.** International customers won't appear; use
  the EU VIES BTW number validator for those (not part of this module).
- **Lookups are not stored as full snapshots.** If KvK data changes (a
  trading name update, an address move), you need to re-run the lookup —
  ERPNext won't notice on its own. Plan a periodic refresh for active
  customers if the freshness matters for compliance.
- **Buttons hidden if not configured.** If the API key isn't set on
  Netherlands Localization Settings, the buttons stay hidden — the form
  doesn't bother you with a feature you can't use.

## What about the BTW number?

KvK number ≠ BTW number. The BTW number is issued separately by the
Belastingdienst. ERPNext's standard `tax_id` field is where the BTW
number goes; the KvK number lives in the *custom_kvk_number* field added
by this module.

If you need to validate the BTW number against EU VIES, that's a separate
feature on the roadmap.