v10 - Shipping Labels - Demo Endpoints

Request a shipping label for a shipping label offer id.

Use a shippable configuration of a number of order items and a shipping label offer id to request a shipping label.

POST /retailer-demo/shipping-labels

  • Request

  • Response

Accept: application/vnd.retailer.v10+json
Content-Type: application/vnd.retailer.v10+json
Authorization: Bearer token (omitted)

{
  "orderItems" : [ {
    "orderItemId" : "2095052647",
    "quantity" : 3
  } ],
  "shippingLabelOfferId" : "8f956bfc-fabe-45b4-b0e1-1b52a0896b74"
}

Content-Type: application/vnd.retailer.v10+json

Status: 202 ACCEPTED

{
  "processStatusId" : "1",
  "eventType" : "CREATE_SHIPPING_LABEL",
  "description" : "Create shipping label with shipping label offer id 8f956bfc-fabe-45b4-b0e1-1b52a0896b74.",
  "status" : "PENDING",
  "createTimestamp" : "2025-07-09T14:08:43+02:00",
  "links" : [ {
    "rel" : "self",
    "href" : "http://api.bol.com/shared-demo/process-status/1",
    "method" : "GET"
  } ]
}

Get VVB delivery options for a shippable configuration

Endpoint returns delivery options for a shippable configuration of a number of order items belonging to an open order. A delivery options contains a shipping label offer id which you can use to request a shipping label.

POST /retailer-demo/shipping-labels/delivery-options

  • Request

  • Response

Accept: application/vnd.retailer.v10+json
Content-Type: application/vnd.retailer.v10+json
Authorization: Bearer token (omitted)

{
  "orderItems" : [ {
    "orderItemId" : "2095052647",
    "quantity" : 1
  } ]
}

Content-Type: application/vnd.retailer.v10+json

Status: 200 OK

{
  "deliveryOptions" : [ {
    "shippingLabelOfferId" : "32c4a88c-3c64-41ad-83a1-24450b341747",
    "recommended" : true,
    "validUntilDate" : "2020-10-17",
    "transporterCode" : "TNT",
    "labelType" : "PARCEL",
    "labelDisplayName" : "PostNL & bol.com - Pakket",
    "labelPrice" : {
      "totalPrice" : 4.41
    },
    "packageRestrictions" : {
      "maxWeight" : "10 kg",
      "maxDimensions" : "100 x 50 x 50 cm"
    },
    "handoverDetails" : {
      "meetsCustomerExpectation" : true,
      "earliestHandoverDateTime" : "2020-10-02T00:00:00+02:00",
      "latestHandoverDateTime" : "2020-10-03T18:00:00+02:00",
      "collectionMethod" : "DROP_OFF"
    }
  }, {
    "shippingLabelOfferId" : "fb7f20c0-d847-4d62-9c57-7aba64fb9b52",
    "recommended" : false,
    "validUntilDate" : "2020-10-08",
    "transporterCode" : "TNT_BRIEF",
    "labelType" : "MAILBOX_LIGHT",
    "labelDisplayName" : "PostNL & bol.com - Brievenbus",
    "labelPrice" : {
      "totalPrice" : 2.88
    },
    "packageRestrictions" : {
      "maxWeight" : "2 kg",
      "maxDimensions" : "38 x 26,5 x 3,2 cm"
    },
    "handoverDetails" : {
      "meetsCustomerExpectation" : true,
      "latestHandoverDateTime" : "2020-09-24T18:30:00+02:00",
      "collectionMethod" : "DROP_OFF"
    }
  } ]
}

Get delivery options for a shippable configuration

Endpoint returns delivery options for a shippable configuration of a number of order items belonging to an open order. A delivery options contains a shipping label offer id which you can use to request a shipping label.

POST /retailer-demo/shipping-labels/delivery-options

  • Request

  • Response

Accept: application/vnd.retailer.v10+json
Content-Type: application/vnd.retailer.v10+json
Authorization: Bearer token (omitted)

{
  "orderItems" : [ {
    "orderItemId" : "2096224434",
    "quantity" : 1
  } ]
}

Content-Type: application/vnd.retailer.v10+json

Status: 200 OK

{
  "deliveryOptions" : [ {
    "shippingLabelOfferId" : "c29afac7-9700-4818-b654-97d1d334999c",
    "recommended" : false,
    "validUntilDate" : "2020-10-12",
    "transporterCode" : "TNT_BRIEF",
    "labelType" : "MAILBOX_LIGHT",
    "labelDisplayName" : "PostNL & bol.com - Brievenbus",
    "labelPrice" : {
      "totalPrice" : 2.88
    },
    "packageRestrictions" : {
      "maxWeight" : "2 kg",
      "maxDimensions" : "38 x 26,5 x 3,2 cm"
    }
  }, {
    "shippingLabelOfferId" : "7d3205e2-7ac1-40ca-a52f-952066b57353",
    "recommended" : false,
    "validUntilDate" : "2020-10-12",
    "transporterCode" : "TNT",
    "labelType" : "MAILBOX",
    "labelDisplayName" : "PostNL & bol.com - Brievenbus",
    "labelPrice" : {
      "totalPrice" : 3.9
    },
    "packageRestrictions" : {
      "maxWeight" : "2 kg",
      "maxDimensions" : "38 x 26,5 x 3,2 cm"
    }
  }, {
    "shippingLabelOfferId" : "da28efa7-243c-444e-b74f-be21bc2dfa71",
    "recommended" : false,
    "validUntilDate" : "2020-10-12",
    "transporterCode" : "DPD-NL",
    "labelType" : "PARCEL",
    "labelDisplayName" : "DPD & bol.com - Pakket",
    "labelPrice" : {
      "totalPrice" : 4.79
    },
    "packageRestrictions" : {
      "maxWeight" : "20 kg",
      "maxDimensions" : "100 x 50 x 50 cm"
    }
  }, {
    "shippingLabelOfferId" : "06636e98-e26a-4747-8ad2-786fa8a514c6",
    "recommended" : true,
    "validUntilDate" : "2020-10-12",
    "transporterCode" : "DHLFORYOU",
    "labelType" : "PARCEL",
    "labelDisplayName" : "DHL & bol.com - Pakket",
    "labelPrice" : {
      "totalPrice" : 4.69
    },
    "packageRestrictions" : {
      "maxWeight" : "20 kg",
      "maxDimensions" : "80 x 50 x 35 cm"
    }
  }, {
    "shippingLabelOfferId" : "aea9abd0-9e20-424d-954a-d01585b23559",
    "recommended" : false,
    "validUntilDate" : "2020-10-12",
    "transporterCode" : "TNT",
    "labelType" : "PARCEL",
    "labelDisplayName" : "PostNL & bol.com - Pakket",
    "labelPrice" : {
      "totalPrice" : 6.65
    },
    "packageRestrictions" : {
      "maxWeight" : "10 kg",
      "maxDimensions" : "100 x 50 x 50 cm"
    }
  } ]
}

Get metadata headers for a shipping label

This HEAD request does not return any data, but will return the headers for the get request, amongst which the track and trace, transporter and content-disposition headers.

HEAD /retailer-demo/shipping-labels/c628ba4f-f31a-4fac-a6a0-062326d0dbbd

  • Request

  • Response

Accept: application/vnd.retailer.v10+pdf
Content-Type: None
Authorization: Bearer token (omitted)

This endpoint has no request body.

Content-Type: None
Content-Disposition: attachment; filename=ShippingLabel_c628ba4f-f31a-4fac-a6a0-062326d0dbbd.pdf
X-Transporter-Code: TNT
X-Track-And-Trace-Code: 3SBLCQ928933678

Status: 200 OK

This endpoint has no response body.

Get a shipping label for an existing shipping label id

Note: demo endpoint doesn’t return a PDF file but a fake, as this is not supported.

GET /retailer-demo/shipping-labels/c628ba4f-f31a-4fac-a6a0-062326d0dbbd

  • Request

  • Response

Accept: application/vnd.retailer.v10+pdf
Content-Type: None
Authorization: Bearer token (omitted)

This endpoint has no request body.

Content-Type: application/vnd.retailer.v10+pdf
Content-Disposition: attachment; filename=ShippingLabel_c628ba4f-f31a-4fac-a6a0-062326d0dbbd.pdf
Content-Length: 141
X-Transporter-Code: TNT
X-Track-And-Trace-Code: 3SBLCQ928933678

Status: 200 OK

THIS IS A FAKE PDF FILE AND IS INTENDED FOR TESTING PURPOSES ONLY. For more information check our documentation on https://developers.bol.com