Netherlands

eKYB Prefill in the Netherlands leverages the Netherlands' source of truth to automatically retrieve and populate business information based on a company's KvK number or RSIN, including the business name, registered address, entity type, registration status, directors, and additional corporate data, without requiring manual input from the user.

Source

Direct API approach

For general integration notes and shared response semantics, see the eKYB Prefill API Reference.

All module configurations and user data can be forwarded directly in the request for performing a Prefill lookup. This overrides existing configuration and data collected about the user.

Endpoint

POST /omni/externalVerification/ekyb-prefill

Request parameters

Tax ID formats

The taxId field accepts two Dutch business identifier types. Routing between them is determined automatically by the format of the submitted value.

Inputs that do not match either format return a 400 error. RSIN is not issued to sole traders — searching by RSIN will not return sole trader records.

Sample request

{
    "plugins": ["ekyb-prefill"],
    "source": "NL_KYB_PREFILL",
    "country": "NL",
    "taxId": "12345678",
    "businessName": "Noorderlicht Ventures B.V.",
    "address": "Lindengracht 42, 1015 KJ Amsterdam, Netherlands"
}

Sample response

The Prefill response returns business data retrieved directly from the source of truth. Fields are returned as-is from the source. nameMatch and addressMatch are only present when businessName or address were submitted in the request. vatNo is absent for sole traders. Director position names and authority levels are returned in Dutch and are not translated. shareholders is typically absent for Dutch BV companies, as shareholder registers commonly show only an aggregate share capital figure.

Example 1 — Noorderlicht Ventures B.V. (sole trader)

{
  "kyb-prefill": [
    {
      "tin": "12345678",
      "name": "Noorderlicht Ventures B.V.",
      "nameMatch": "Verified",
      "address": "Lindengracht 42, 1015 KJ Amsterdam, Netherlands",
      "city": "Amsterdam",
      "postalCode": "1234RV",
      "entityType": "Sole trader with one owner",
      "registrationStatus": "Active",
      "registrationDate": "2012-12-11T00:00:00Z",
      "creditRating": "C",
      "creditRatingDescription": "Moderate Risk",
      "industryDesc": "Activities of Noorderlicht",
      "activityDesc": "Activities of Noorderlicht",
      "employeeCount": "1",
      "websites": ["www.daanvandijk.nl"],
      "directors": [
        { "name": "Daan van Dijk", "positionName": "Eigenaar" }
      ],
      "otherNames": [
        { "name": "Noorderlicht", "businessNameType": "Trading Name" }
      ]
    }
  ]
}

Example 2 — Noorderlicht Trader B.V. (private limited company)

{
  "kyb-prefill": [
    {
      "tin": "12345678",
      "vatNo": "123456789",
      "name": "Noorderlicht Trader B.V.",
      "nameMatch": "Verified",
      "address": ": "Tulpenlaan 27, 3511 AB Utrecht, Netherlands",
      "entityType": "Private limited liability company (BV) with ordinary structure",
      "registrationStatus": "Active",
      "registrationDate": "2019-12-17T00:00:00Z",
      "creditRating": "E",
      "creditRatingDescription": "Not Rated",
      "industryDesc": "Retail sale of motor vehicles",
      "activityDesc": "Retail sale of motor vehicles",
      "employeeCount": "2",
      "directors": [
        { "name": "Daan van Dijk", "positionName": "Algemeen Directeur", "authority": "Alleen/zelfstandig bevoegd" },
        { "name": "Daan van Dijk", "positionName": "Algemeen Directeur", "authority": "Alleen/zelfstandig bevoegd" }
      ],
      "otherNames": [
        { "name": "Noorderlicht Trader B.V.", "businessNameType": "Trading Name" }
      ]
    }
  ]
}

Response fields

Name and address match values

Registration status values

Error responses

For standard HTTP response codes, see the API Error Response page. Netherlands Prefill returns the following country-specific 400 errors.

taxId is missing, empty, or does not match a supported Dutch identifier format:

{
    "timestamp": 1782851408892,
    "status": 400,
    "error": "Bad Request",
    "message": "taxId must be a valid Dutch identifier: KvK number (8 digits) or RSIN (9 digits)",
    "path": "/omni/externalVerification/ekyb-prefill"
}

Any mandatory field (plugins, source, country, or taxId) is missing:

{
    "timestamp": 1782851468367,
    "status": 400,
    "error": "Bad Request",
    "message": "must not be blank",
    "path": "/omni/externalVerification/ekyb-prefill"
}

No business match is found for the submitted taxId:

{
    "timestamp": 1782851583695,
    "status": 200,
    "message": "No business found matching the provided tax ID.",
    "path": "/omni/externalVerification/ekyb-prefill"
}

Single Session Dashboard results

Prefill results are available on the Business tab in Single Session view.