Postnl.nl

How to use

Bedrijfscheck Nationaal

Get your API key

API keys are unique codes that identify you or your application each time you make a call to one of our API’s.

To make API requests you will need an API Key. Please register in order to receive credentials.

Run sample requests

You access PostNL DataSolutions API’s without writing any code. Just use this Bedrijfsscheck Nationaal.json and import this in Postman on your preferred OS.

Your test account allows you to play with input & output. By default this test account is limited to 250 calls. In case of questions, use the contact details sent to you by email to confirm your (test)account.

After setting up your API, please read the Documentation tab to find a Postman import file, samples and field details.

Connect to the services

Get familiar with our API Documentation and inform yourself before integrating any of our services.

Implementation of PostNL API’s requires expertise and resources by (a) qualified developer(s).

Read the documentation

Get familiar with our API documentation. The detail essential information common to all of our services. You need to be aware of these conventions before integrating any of our services.

Go to production

If testing goes well and you like what you see, you can apply for a paid production account.

In order to fully integrate the API’s into your website, e-commerce platform and/or backend application(s), you need a production account. While registering as a PostNL customer you receive personalized login credentials for Quota Manager, for accessing and managing your API key(s) and quota.

Do you already have a PostNL DataSolutions contract number and you don’t use the PostNL DataSolutions API’s? Please contact your Account Manager or fill out this form. See API Manager for managing your keys and usage.

Instructions

Components of the Bedrijfscheck Nationaal

This product offers four API’s.

  1. companySearch – Returns company information based on exact search inputs: Chamber of Commerce registration number and/or branchnumber, RSIN or PostNL key.
  2. companyNameAndAddress – Returns company information based on exact or fuzzy search inputs, where company name is mandatory and address fields are optional.
  3. companyAddress – Returns company information based on exact or fuzzy search inputs of address components.
  4. companyPhone – Returns company information based on registered company phone number.
  5. companyDetails – Returns detailed information about a single company, based on the exact inputs of (a) Chamber of Commerce registration number with branchnumber or (b) PostNL key.
  6. companyDetailsExtra – Returns additional detailed information about a single company, including contact information on DMU level, based on the exact inputs of (a) Chamber of Commerce registration number with branchnumber or (b) PostNL key.

Please note that a seventh and eighth API will be deployed soon. These additional APIs will be stackable with the current Bedrijfscheck Nationaal API’s. It will output respectively Signatory Authorities within an organization and an extract of the Chamber of Commerce.

See Documentation for detailed API settings and fields.

Combining API's, a regex example

Suppose your product owner / client wishes an input field that multiple inputs: kvknumber, some address component and a company name.

In this case REGEX might be of assistance:

  • Find word boundaries with \b in regex (source)
  • Identify real postal codes with regex [1-9][0-9]{3} ?(?!sa|sd|ss)[a-z]{2} (source)
  • Identify kvknumber / chamber fo commerce idenitifier with regex [0-9]{5,8}

Use your if/elses right for choosing the right and fastest API in each case:

  • API 1 for kvknumber,
  • API 2 for company name with optional address component, like an easy recognizable ZIP code and
  • API 3 for searching on ZIP code only.

You might create something like this (watch in HD):

How to use