Testtool REST

Return on Demand webservice

PostNL offers the possibility of picking up return parcels at a specific location. This offers additional convenience for the consumer. By requesting the Return on Demand API call (quote), PostNL will provide available time frames for the given location. After a time frame is chosen by the consumer, you can request the Return on Demand API call (purchase) to claim the specific time frame.
• You share the available time frames with the consumer, e.g. as part of your webshop checkout where a return parcel is announced. The consumer chooses from the available timeframes.
• The consumer has to put a return label on the return parcel with a valid barcode.
• The consumer will be notified by PostNL that a parcel will be picked up at the requested address.
• The barcode will be scanned at pickup.

The following methods are defined within the Labelling WebService.




First, you have to check which timeframes are available for the specified address, the Quote.


To claim a timeframe, you post a purchase with one of the provided timeframes in the Quote response.

Interface version  (REST only)v1 
Sandbox endpointhttps://api-sandbox.postnl.nl/shipment/v1/pickuporder
Sandbox swaggerhttps://api-sandbox.postnl.nl/shipment/v1/pickuporder/swagger.json
Production endpointhttps://api.postnl.nl/shipment/v1/pickuporder
Production swaggerhttps://api.postnl.nl/shipment/v1/pickuporder/swagger.json




Release Date


Schema Changes

Return on Demand


Okt 01, 2018

Current version


The parcel that needs to be picked up, will have to contain a label with a valid 3S barcode, that has been confirmed separately to PostNL. The pickuporder service cannot be used with Smart Returns (“Printerloos Retourneren”).