GET /checkout/v4/baskets

Gets the basket, for users with a session (both anonymous and authenticated).

Request URL structure:
https://api.bol.com/checkout/v4/baskets

Request HTTP method:
GET

Request requires session:
X-OpenAPI-Session-ID HTTP header is required. Use the session aquired in login or GET sessions to acquire a valid sessionId.

Request parameters:

Name

Location

Data type

Required

Description

format

Query

Text

No

json (default): the response is returned in JSON. xml: the response is returned in XML

 

Response:

Element

Min

Max

Description

basket

1

1

The complete contents of the basket

Request / Response example:

Request: https://api.bol.com/checkout/v4/baskets?apikey={apikey}

Response HTTP status code: 200

Response XML:

{

  "totalAmountArticles": 99.9,

  "subTotal": 99.9,

  "shippingFee": 0,

  "total": 99.9,

  "serviceFee": 0,

  "giftWrapFee": 0,

  "totalQuantity": 2,

  "shippableAbroad": true,

  "combinable": false,

  "openForUse": true,

  "specialRequirements": [

    "OPTIONAL_DELIVERY_APPOINTMENT"

  ],

  "basketItem": [

    {

      "id": "218596050",

      "price": 49.95,

      "quantity": 2,

      "state": "Nieuw",

      "listPrice": 0,

      "availabilityCode": "102",

      "availabilityDescription": "Op werkdagen besteld, binnen 1-2 werkdagen in huis.",

      "secondHand": false,

      "seller": {

        "id": "0",

        "sellerType": "bol.com",

        "displayName": "bol.com",

        "url": "www.bol.com"

      },

      "product": {

        "id": "1001004002126206",

        "ean": "9789026317729",

        "gpc": "book",

        "title": "Oorlog en vrede",

        "summary": "Nederlands - Hardcover | 2005",

        "rating": 46,

        "shortDescription": "Dit is de beknopte versie van \"Oorlog & Vrede\"",

        "longDescription": "Dit is de beknopte versie van \"Oorlog & Vrede\"",

        "urls": [

          {

            "key": "DESKTOP",

            "value": "http://www.test.bol.com/nl/p/oorlog-en-vrede/1001004002126206/"

          },

          {

            "key": "MOBILE",

            "value": "https://m.test.bol.com/nl/p/oorlog-en-vrede/1001004002126206/"

          }

        ],

        "images": [

          {

            "type": "IMAGE",

            "key": "XS",

            "url": "http://s-test.s-bol.com/imgbase0/imagebase/mini/FC/6/0/2/6/1001004002126206.jpg"

          },

          {

            "type": "IMAGE",

            "key": "S",

            "url": "http://s-test.s-bol.com/imgbase0/imagebase/tout/FC/6/0/2/6/1001004002126206.jpg"

          },

          {

            "type": "IMAGE",

            "key": "M",

            "url": "http://s-test.s-bol.com/imgbase0/imagebase/thumb/FC/6/0/2/6/1001004002126206.jpg"

          },

          {

            "type": "IMAGE",

            "key": "L",

            "url": "http://s-test.s-bol.com/imgbase0/imagebase/regular/FC/6/0/2/6/1001004002126206.jpg"

          },

          {

            "type": "IMAGE",

            "key": "XL",

            "url": "http://s-test.s-bol.com/imgbase0/imagebase/large/FC/6/0/2/6/1001004002126206.jpg"

          }

        ],

        "media": [

          {

            "type": "IMAGE",

            "key": "Oorlog en vrede",

            "url": "http://s-test.s-bol.com/imgbase0/imagebase/large/FC/6/0/2/6/1001004002126206.jpg"

          },

          {

            "type": "IMAGE",

            "key": "Oorlog en vrede",

            "url": "http://s-test.s-bol.com/imgbase0/imagebase/large/FC/6/0/2/6/1001004002126206_b.jpg"

          }

        ]

      }

    }

  ]

}