{"slug":"postnl-api","name":"PostNL API","host":"api.postnl.nl","site":"https://postnl.nl","category":"shipping","docsUrl":null,"sources":[{"kind":"changelog","url":"https://developer.postnl.nl/operational-status/changelog"}],"url":"https://www.okapi.bot/providers/postnl-api/","json":"https://www.okapi.bot/api/v1/providers/postnl-api.json","breakingChanges":[{"slug":"post-parcels-v1-shipment-activatereturn-stops-working","api":"postnl-api","title":"POST /parcels/v1/shipment/activatereturn stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-04-03","effectiveAt":"2026-08-01","scope":null,"calls":["POST /parcels/v1/shipment/activatereturn"],"method":"POST","path":"/parcels/v1/shipment/activatereturn","source":{"url":"https://developer.postnl.nl/operational-status/changelog","kind":"archive"},"quote":"Effective 1 August 2026, calls to this endpoint will no longer be accepted. Requests will result in an error response.","migration":"Stop creating Shipment and Return labels (Characteristic 152 / Option 026) and the handover blockade; manifest each return as a new return shipment with a new barcode (Returns API v4 or a return label).","migrationChange":null,"needsDecision":"The Shipment and Return label service is withdrawn with no direct replacement; returns must be redesigned as separate return shipments.","text":null,"publishedAt":"2026-10-23T10:35:52.140Z","updatedAt":"2026-10-23T10:35:52.140Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/postnl-api/breaking-changes/post-parcels-v1-shipment-activatereturn-stops-working/"}]}