PostNL Prepare Shipment Url

Fetches the URL to the PostNL website, for printing the web stamp. Parameters for this request specify for which product the stamp is going to be printed and if the user agrees with Marktplaats sharing his/her information with PostNL.

Parameters

name required default constraints
itemId yes
withUserData None false

itemId

Unique reference to the Marktplaats advertisement to print the stamp for.

withUserData

Indicates if the user agrees with Marktplaats sharing his/her information with PostNL. The shared date are name, email and postal code.

Errors

http error code description
500 internal-server-error Oops! Sorry, something went wrong on our side.
400 invalid-item-id The item id provided does not match [a-z][0-9]*.

Reference

GET /v1/postnl/prepare-shipment-url

Examples

Get PostNL catalog

Request :

GET /v1/postnl/prepare-shipment-url?itemId=m1&withUserData=true catalog HTTP/1.1
Host: api.marktplaats.nl

Response :

HTTP/1.1 200 OK
Content-Type: application/json

{
"_links": {
  "self": {
    "href": "/v1/postnl/prepare-shipment-url"
  }
},
"url":"https://jouw.postnl.nl/web/api/bootstrap/preparedOrder/cdc74987-7b1c-4835-88ea-e772d9568b9b"
}