KVK UBO Register Extract

With the UBO-uittreksel API, you can request the current UBO extract for an organisation based on its registration (KVK number). The UBO extract shows whether any UBOs are registered for the organisation in question.

Connecting

Before you can use this API, you need to arrange a few things. 

Terms and Conditions

Please note that the application process takes some time. Due to security checks, we cannot connect you immediately on the day of your application. Authorisation is also granted carefully and in a controlled manner. For this reason, we cannot grant access to all organisations simultaneously. We process applications on a first-come, first-served basis. We therefore advise banks to submit their applications in a timely manner. 

Frequently Asked Questions

A UBO extract is an official document from the UBO register that lists the Ultimate Beneficial Owners (UBOs) of an organisation. The UBO is a natural person who ultimately owns an organisation or has effective control over it.

Not everyone has access to the UBO register. 

  • UBOs can view their own UBO data. 
  • Organisations that have registered UBOs can view their own UBO registration. 
  • Some organisations have access to all UBO data. The access level allows an organisation to view the UBO data.

The UBO register has 3 access levels: UBOB1, UBOB2, and UBOB3. Read more about the UBO register access levels.

The UBO extract contains information about the societal activity/business, the UBO, the type and extent of the interest, and any notifications submitted.

View all information in the UBO extract.

Requesting a UBO extract costs €3.10.

The UBO extract API works slightly differently than the other APIs. The extract is provided in PDF format. The PDF has a digital certification.

You can reuse the certificate if it meets the correct requirements.

By default, you only receive data corresponding to the lowest authorisation level (UBOB1). Do you want to retrieve data that matches your authorisation level? Then use the 'priveVolledig' option and set it to 'true'.

The status 200 indicates that the API has successfully processed the request, but not whether the PDF file has also been correctly processed by your software. 

Chunked encoding 

The PDF is returned as binary data in the response. Chunked encoding can be used for this. Instead of sending the data in one package, it is sent in parts. Your software may not be able to handle this. Therefore, first check whether your software receives and saves the file correctly before attempting to open or convert it.

Request a UBO extract

Once the authorisation has been granted and the certificate has been uploaded, you can request the UBO extract.

1. Retrieve Acces Token

The first step is to retrieve an access token. You can do this using the endpoint below.

You include the token in the Authorization header for all subsequent API calls. In addition, the client certificate must also be sent, which is used to establish the mTLS connection.

Endpoint

https://api-secure.kvk.nl/auth/oauth/v2/token

2. Create order

  • Use the endpoint below to create a UBO extract order. 
  • By default, you only receive data corresponding to the lowest authorisation level (UBOB1). Do you want to retrieve data that matches your authorisation level? Then use the 'priveVolledig' option and set it to 'true'.
  • The order is processed asynchronously. This means it is processed in the background, and you will not receive a final result immediately.

Endpoint

https://api-secure.kvk.nl/api/v1/order/uittreksels/ubo

3. Request order status

You can use the endpoint below to request the status of your previously created order. Once the order is processed, the response will include a download link to the UBO extract.

Endpoint

https://api-secure.kvk.nl/api/v1/orders/status/{ordernummer}

4. Download UBO extract in PDF format

The system provides the UBO extract via a direct download link. This download URL can be obtained by requesting the order status (endpoint in step 3).

Endpoint

https://api-secure.kvk.nl/api/v1/vbu/uittreksels/{ordernummer}.pdf

OpenAPI Specification