# Bol Offers API

**Canonical:** https://apis.io/apis/bol-com/bol-com-offers-api/  
**Provider:** Bol — https://apis.io/providers/bol-com/  
**Base URL:** https://api.bol.com/retailer/public/  
**Documentation:** https://api.bol.com/retailer/public/Retailer-API/index.html

Bol Offers API is one of 15 APIs that [Bol](https://apis.io/providers/bol-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Offers. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Offer resource

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| POST | `/retailer/offers` | Create a new offer |
| POST | `/retailer/offers/export` | Request an offer export file |
| GET | `/retailer/offers/export/{report-id}` | Retrieve an offer export file by report id |
| POST | `/retailer/offers/unpublished` | Request an unpublished offer report |
| GET | `/retailer/offers/unpublished/{report-id}` | Retrieve an unpublished offer report by report id |
| GET | `/retailer/offers/{offer-id}` | Retrieve an offer by its offer id |
| PUT | `/retailer/offers/{offer-id}` | Update an offer |
| DELETE | `/retailer/offers/{offer-id}` | Delete offer by id |
| PUT | `/retailer/offers/{offer-id}/price` | Update price(s) for offer by id |
| PUT | `/retailer/offers/{offer-id}/stock` | Update stock for offer by id |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/bol-com/openapi/bol-com-offers-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/bol-com/json-schema/bol-com-retailer-offer-schema.json
- **JSONSchema** — https://artifacts.apis.io/bol-com/json-schema/bol-com-create-offer-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/bol-com/json-schema/bol-com-replenishment-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/bol-com/json-schema/bol-com-update-offer-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/bol-com/json-schema/bol-com-subscription-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/bol-com/json-schema/bol-com-subscription-request-schema.json

## Other Bol APIs (12)

- [Bol Commissions API](https://apis.io/apis/bol-com/bol-com-commissions-api/)
- [Bol Insights API](https://apis.io/apis/bol-com/bol-com-insights-api/)
- [Bol Inventory API](https://apis.io/apis/bol-com/bol-com-inventory-api/)
- [Bol Invoices API](https://apis.io/apis/bol-com/bol-com-invoices-api/)
- [Bol Orders API](https://apis.io/apis/bol-com/bol-com-orders-api/)
- [Bol Products API](https://apis.io/apis/bol-com/bol-com-products-api/)
- [Bol Promotions API](https://apis.io/apis/bol-com/bol-com-promotions-api/)
- [Bol Replenishments API](https://apis.io/apis/bol-com/bol-com-replenishments-api/)
- [Bol Retailers API](https://apis.io/apis/bol-com/bol-com-retailers-api/)
- [Bol Returns API](https://apis.io/apis/bol-com/bol-com-returns-api/)
- [Bol Shipments API](https://apis.io/apis/bol-com/bol-com-shipments-api/)
- [Bol Shipping Labels API](https://apis.io/apis/bol-com/bol-com-shipping-labels-api/)

## Tags

Offers

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/bol-com/bol-com-offers-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/bol-com/.