Endpoint details for the Retailer offer API (v11) on the bol.com marketplace.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"1870210","collectionId":"6bad3863-324f-4bd9-9126-585c8c22f8c3","publishedId":"2sB3WyLcUL","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-11-24T07:32:29.000Z"},"item":[{"name":"GET /offers/ - Retrieve existing offers","id":"ef04c43e-d3c5-46d9-96a8-f0701431aaee","protocolProfileBehavior":{"disabledSystemHeaders":{"accept":true},"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/vnd.retailer.v11+json","type":"text"},{"key":"Accept","value":"application/vnd.retailer.v11+json","type":"text"}],"url":"/retailer/offers","description":"Retrieve all existing offers from the bol marketplace.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6bad3863-324f-4bd9-9126-585c8c22f8c3","id":"6bad3863-324f-4bd9-9126-585c8c22f8c3","name":"bol.com Retailer Offer API v11","type":"collection"}},"urlObject":{"path":["retailer","offers"],"host":[""],"query":[{"disabled":true,"key":"offer-ids","value":""},{"disabled":true,"key":"eans","value":""},{"disabled":true,"key":"reference","value":""},{"disabled":true,"key":"for-sale","value":""},{"disabled":true,"key":"last-modified-date-time","value":""},{"disabled":true,"key":"page-size","value":""},{"disabled":true,"key":"cursor","value":""}],"variable":[]}},"response":[],"_postman_id":"ef04c43e-d3c5-46d9-96a8-f0701431aaee"},{"name":"GET /offers/{{offer-id}} - Retrieve offer by offerId","id":"95f4a7f1-ccd0-4452-b256-9f936b4698f3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/vnd.retailer.v11+json","type":"text"},{"key":"Accept","value":"application/vnd.retailer.v11+json","type":"text"}],"url":"/retailer/offers/","description":"Retrieve a single offer by offerId
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6bad3863-324f-4bd9-9126-585c8c22f8c3","id":"6bad3863-324f-4bd9-9126-585c8c22f8c3","name":"bol.com Retailer Offer API v11","type":"collection"}},"urlObject":{"path":["retailer","offers",""],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"95f4a7f1-ccd0-4452-b256-9f936b4698f3"},{"name":"GET /offers/{{offer-id}}/not-for-sale-reasons - Get not for sale reasons by offerId","id":"8eda9b6c-454f-4bb3-917e-381f6db750ce","protocolProfileBehavior":{"disabledSystemHeaders":{"accept":true},"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/vnd.retailer.v11+json","type":"text"},{"key":"Accept","value":"application/vnd.retailer.v11+json","type":"text"}],"url":"/retailer/offers//not-for-sale-reasons","description":"Retrieve the reason(s) why an offer is marked as offline/not for sale
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6bad3863-324f-4bd9-9126-585c8c22f8c3","id":"6bad3863-324f-4bd9-9126-585c8c22f8c3","name":"bol.com Retailer Offer API v11","type":"collection"}},"urlObject":{"path":["retailer","offers","","not-for-sale-reasons"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"8eda9b6c-454f-4bb3-917e-381f6db750ce"},{"name":"POST /retailer/offers - Create offer","event":[{"listen":"test","script":{"id":"11e0b4a9-c76d-4c49-bfb8-0c1119e3cc3b","exec":["// Parse response body","let response = pm.response.json();","","// Store the ID in an environment or collection variable","pm.collectionVariables.set(\"offerId\", response.offerId);","","// Optional: log it for debugging","console.log(\"Stored ID:\", response.offerId);",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"d3ece939-a38f-47ea-bc08-6946773cc130","protocolProfileBehavior":{"disabledSystemHeaders":{"accept":true},"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/vnd.retailer.v11+json","type":"text"},{"key":"Accept","value":"application/vnd.retailer.v11+json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"ean\": \"4015211100803\",\n \"condition\": {\n \"category\": \"REFURBISHED\",\n \"grade\": \"A\",\n \"margin\": false\n },\n \"onHoldByRetailer\": true,\n \"pricing\": {\n \"bundlePrices\": [\n {\n \"quantity\": 1,\n \"unitPrice\": 9.99\n }\n ]\n },\n \"countryAvailabilities\": [\n {\n \"countryCode\": \"NL\"\n },\n {\n \"countryCode\": \"BE\"\n }\n ],\n \"fulfilment\": {\n \"method\": \"FBR\",\n \"schedule\": \"BOL_DELIVERY_PROMISE\",\n \"deliveryPromise\": {\n \"minimumDaysToCustomer\": 0,\n \"maximumDaysToCustomer\": 1,\n \"ultimateOrderTime\": \"22:00\"\n }\n },\n \"stock\": {\n \"amount\": 5,\n \"managedByRetailer\": false\n }\n}"},"url":"/retailer/offers","description":"Create a new offer on the bol marketplace.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6bad3863-324f-4bd9-9126-585c8c22f8c3","id":"6bad3863-324f-4bd9-9126-585c8c22f8c3","name":"bol.com Retailer Offer API v11","type":"collection"}},"urlObject":{"path":["retailer","offers"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"d3ece939-a38f-47ea-bc08-6946773cc130"},{"name":"PATCH /offers/{{offer-id}} - Update offer by offerId","id":"edfbb7a6-a0fc-4bdd-8267-a8b754a609a0","protocolProfileBehavior":{"disabledSystemHeaders":{"accept":true},"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/vnd.retailer.v11+json","type":"text"},{"key":"Accept","value":"application/vnd.retailer.v11+json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"stock\": {\n \"amount\": 256,\n \"managedByRetailer\":true\n },\n \"pricing\": {\n \"bundlePrices\": [\n {\n \"quantity\": 1,\n \"unitPrice\": 88.99\n }\n ,\n {\n \"quantity\": 10,\n \"unitPrice\": 68.99\n }\n ]\n }\n}"},"url":"/retailer/offers/","description":"Update an offer on the bol marketplace.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6bad3863-324f-4bd9-9126-585c8c22f8c3","id":"6bad3863-324f-4bd9-9126-585c8c22f8c3","name":"bol.com Retailer Offer API v11","type":"collection"}},"urlObject":{"path":["retailer","offers",""],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"edfbb7a6-a0fc-4bdd-8267-a8b754a609a0"},{"name":"DELETE /offers/{{offer-id}} - Delete offer by offerId","id":"18bed18e-6526-4dcb-88f0-670a78bea00e","protocolProfileBehavior":{"disabledSystemHeaders":{"accept":true},"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/vnd.retailer.v11+json","type":"text"},{"key":"Accept","value":"application/vnd.retailer.v11+json","type":"text"}],"url":"/retailer/offers/","description":"Delete an offer from the bol marketplace
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6bad3863-324f-4bd9-9126-585c8c22f8c3","id":"6bad3863-324f-4bd9-9126-585c8c22f8c3","name":"bol.com Retailer Offer API v11","type":"collection"}},"urlObject":{"path":["retailer","offers",""],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"18bed18e-6526-4dcb-88f0-670a78bea00e"},{"name":"Retrieve token","event":[{"listen":"test","script":{"id":"aa58b960-37f7-45e3-be5f-1bb4490d76f0","exec":["var data = JSON.parse(responseBody);","postman.setEnvironmentVariable(\"seller_oauth_token\", data.access_token);",""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"d7774c62-3fb7-4740-80fe-d6aa04436215","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"8a60fb3c-52da-4b47-a591-3a66aaf4a463","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{seller_client_id}}"},{"key":"password","value":"{{seller_client_secret}}"}],"advancedConfig":[{"key":"showPassword","value":"Retrieves the access token for accessing the endpoints.
\n","urlObject":{"path":["token"],"host":[""],"query":[{"key":"grant_type","value":"client_credentials"}],"variable":[]}},"response":[],"_postman_id":"8a60fb3c-52da-4b47-a591-3a66aaf4a463"}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"b7d600b3-7d33-4256-b1a6-bddf94eb0bcb","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"35b19436-8142-4ea4-96b4-87b47f309d1f","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"id":"f8d118ba-16bb-42c4-b1b7-6858c72f08bc","key":"base_url","value":""},{"id":"f92e741c-a2ad-4b2b-aa37-1ecef087d366","key":"offerId","value":""},{"id":"3f5731a3-c6b0-4e1f-8eee-28cd68642627","key":"seller_oauth_token","value":""}]}