Why use the Shipment V4 API
Clear return process
Keep shipping and return flows separate to maintain control over the different workflows.
Tailored to the returns process
The new API supports return request, handling and refunds.
Reduced errors
Fewer mistakes by separating shipping and returns flow
Integrate the newest version
The Return API version 4 can be used to handle your return flow for our customers in the Netherlands, enabling them to send parcels within the Netherlands, to Belgium, and internationally. In the course of 2025, we will add more functionalities.
Right now, this API is available only to a selected group of PostNL customers. If you haven’t received an invite yet, you’re not eligible just yet — but don’t worry. As we continue to add new features and improve the experience, more customers will be invited to join. Thanks for bearing with us – we’re excited to roll out the API to a broader audience soon!
Get started
How to get started
Start with integrating the newest version.
Product overview
View our product and services.
Documentation
View our exhaustive documentation.
Postman
All of our API’s available as Postman collections.
Github
Find PostNL on Github.
Sandbox
Test your integration on our Sandbox environment.