Netherlands eKYB validates the legitimacy of Dutch businesses by checking their tax ID, business name, address, UBOs, and directors against Dutch government sources of truth.
Source
| Country | Source | Description |
|---|---|---|
| Netherlands | Dutch government sources of truth | Verifies submitted business details against records maintained in Dutch registries. |
Direct API approach
For general integration notes and shared response semantics, see the eKYB API Reference.
Request parameters
| Parameter | Required | Description |
|---|---|---|
plugins |
Mandatory | Array. Must be ["ekyb"]. |
businessName |
Mandatory | String. Name of the business. |
country |
Mandatory | String. Two-letter Alpha-2 country code. Must be NL. |
taxId |
Mandatory | String. Accepts VAT (NL + 9 digits + B + 2 digits) or KvK (8 digits). |
street |
Optional | String. Street name of the business. |
houseNo |
Optional | String. Building or house number. |
addressLine2 |
Optional | String. Second line of the business address. |
city |
Optional | String. City in the business address. |
state |
Optional | String. State in the business address. |
postalCode |
Optional | String. Dutch postal code (4 digits, space, and 2 letters). |
uboNames |
Optional | Array. Full legal names of Unique Beneficial Owners to check against records associated with the business. |
directors |
Optional | Array. Full legal names of directors to check against records associated with the business. |
Sample request
{
"plugins": ["ekyb"],
"businessName": "Tulip Tech B.V.",
"street": "Herengracht",
"houseNo": "100",
"city": "AMSTERDAM",
"state": "NORD-HOLLAND",
"postalCode": "1015BS",
"country": "NL",
"taxId": "12345678",
"uboNames": ["Sanne de Vries"],
"directors": ["Jeroen van Dijk"]
}
Sample response
{
"kyb": [
{ "key": "name", "sub_label": "Verified" },
{ "key": "tin", "sub_label": "Verified", "reasonCodes": ["REGNO"] },
{ "key": "address_verification", "sub_label": "Verified" },
{ "key": "cityMatch", "sub_label": "Verified" },
{ "key": "postalCodeMatch", "sub_label": "Verified" },
{ "key": "registrationStatus", "sub_label": "Active" },
{
"key": "entityType",
"entityType": { "entityType": "Private limited liability company" }
},
{ "key": "ubo_name_match", "sub_label": "Unverified", "uboName_input": "Daan Visser" },
{ "key": "ubo_name_match", "sub_label": "Unverified", "uboName_input": "Sarah Smith" },
{ "key": "directors_name_match", "sub_label": "Unverified", "directorsName_input": "Andrew Martin" },
{ "key": "directors_name_match", "sub_label": "Verified", "directorsName_input": "Thijs Mulder" }
]
}
Response fields
| Key | Status | Description |
|---|---|---|
name |
Verified, Approximate Match, Unverified |
Submitted business name against the business name associated with the tax ID. |
tin |
Verified, Not Verified |
Submitted tax ID against the government database. |
address_verification |
Verified, Approximate Match, Unverified |
Submitted address against the address associated with the tax ID. |
cityMatch |
Verified, Approximate Match, Unverified |
Submitted city against the city associated with the tax ID. |
postalCodeMatch |
Verified, Unverified |
Submitted postal code against the postal code associated with the tax ID. |
registrationStatus |
Active, Inactive, Unknown |
Registration status of the business. Inactive includes suspended businesses and those no longer in operation. |
entityType |
Legal entity type of the business | The legal entity type of the company, if available. If not available, displays Unknown. |
ubo_name_match |
Verified, Approximate Match, Unverified |
Submitted UBO against UBOs associated with the business. Distinguished by the uboName_input field on each entry. |
directors_name_match |
Verified, Approximate Match, Unverified |
Submitted director against directors associated with the business. Distinguished by the directorsName_input field. |
Error responses
See the eKYB API Reference for standard error responses.
Single Session Dashboard results
View eKYB results on the Business tab in single Session view.