New API platform

New platform endpoints

PostNL has launched a new API platform. The former webservices have been migrated to this platform, so that we can keep providing good service. To make use of this new platform you have to use the new endpoints. You can find the endpoints at the Developer Center at all the documentation pages (paragraph Calls details) of the Parcels API’s.


The current CIF username / password combination will be replaced by an API key in the SOAP API calls. This API key should be added into the header of your API requests. 

You can also fill in the API key in the former password field and send the same CIF requests as you did before.  

Version upgrades

The PostNL APIs are constantly being improved and enhanced with new products
and functionalities. PostNL expects users to regularly upgrade their versions of the APIs, so they are always using a supported version of the integrated services.
Some older versions have not been migrated to the new platform. Users of these APIs will therefore be obliged to update the outdated version(s).
Documentation and Versioning of the APIs can be found on the Documentation pages of the Parcels APIs.

Location API 2.0

If you are currently using the CIF Location 2.0 version, please upgrade to the 2.1 version. No changes have been made in the request interface in the updated version. The only change is that the Location Type has been extended with partner Location Codes (Response Location Code).


In the new environment you can find all the namespaces at the top of the response instead of the spread namespaces in the CIF responses. This will not change the way in which responses are handled.  
The xml messages have now become more compact and manageable.

Error messages

Some of the error messages and warnings in the response may differ from the former CIF messages. The struvcture is still the same, for examples:


Due to the increasing need and demand for RESTful APIs, we also have REST variants with JSON format available now.
For example: When showing the delivery options in the webshop checkout, these new APIs can improve and facilitate interoperability and make it easier to implement the services.
You can find information and test these APIs on the REST Documentation pages.