aid: bol-com
name: Bol
description: Bol is a leading Dutch e‑commerce platform that connects millions of consumers with a vast marketplace of products. Through its public
  developer portal, Bol offers Retailer and Advertising APIs that enable partners to automate product listings, order processing, inventory management,
  pricing, and advertising campaigns. The APIs provide comprehensive documentation, authentication mechanisms, rate‑limit details, and support
  resources, allowing seamless integration for retailers and advertisers looking to sell on Bol’s marketplace.
url: https://artifacts.apis.io/bol-com/apis.yml
x-type: company
x-source: harvest:new-submission
x-tier: profiled
x-tier-reason: enrichment pass 2026-10-28 (modular-v1; was harvest)
specificationVersion: '0.20'
created: '2026-10-28'
modified: '2026-10-28'
tags:
- e-commerce
- retail
- marketplace
- API
- Netherlands
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
image: https://www.bol.com/favicon.ico
common:
- type: CapabilityMap
  url: capabilities/bol-com-capability-edges.yml
  name: Bol Business Capability Map
- type: SecurityTxt
  url: well-known/bol-com-bol-security.txt
- type: AgenticAccess
  url: agentic-access/bol-com-agentic-access.yml
- type: Spectral
  url: rules/bol-com-rules.yml
- type: JSONLD
  url: json-ld/bol-com-context.jsonld
- type: Vocabulary
  url: vocabulary/bol-com-vocabulary.yml
- type: AgentSkill
  url: skills/_index.yml
- type: DataModel
  url: data-model/bol-com-data-model.yml
- type: Security
  url: https://www.bol.com/nl/nl/klantenservice/a/5715110588841984/bedrijfsgegevens
- type: ErrorCatalog
  url: errors/bol-com-problem-types.yml
- type: Conformance
  url: conformance/bol-com-conformance.yml
- type: SecurityTxt
  url: well-known/bol-com-security.txt
- type: WellKnown
  url: well-known/bol-com-well-known.yml
- type: Hosts
  url: hosts/bol-com-hosts.yml
- type: VulnerabilityDisclosure
  url: security/bol-com-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/bol-com-domain-security.yml
- type: Website
  url: https://bol.com/
- type: DeveloperPortal
  url: https://developers.bol.com/
- type: Documentation
  url: https://developers.bol.com/
- type: APIReference
  url: https://api.bol.com/retailer/public/Retailer-API/index.html
- type: GettingStarted
  url: https://api.bol.com/retailer/public/Retailer-API/retailer-getting-started.html
- type: Support
  url: https://developers.bol.com/en/contact/
- type: News
  url: https://developers.bol.com/en/news/
apis:
- aid: bol-com:bol-com-commissions-api
  name: Bol Commissions API
  description: Commissions resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Commissions
  properties:
  - type: OpenAPI
    url: openapi/bol-com-commissions-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-insights-api
  name: Bol Insights API
  description: Insights resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Insights
  properties:
  - type: OpenAPI
    url: openapi/bol-com-insights-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-inventory-api
  name: Bol Inventory API
  description: Inventory resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Inventory
  properties:
  - type: OpenAPI
    url: openapi/bol-com-inventory-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-invoices-api
  name: Bol Invoices API
  description: Invoice resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Invoices
  properties:
  - type: OpenAPI
    url: openapi/bol-com-invoices-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-offers-api
  name: Bol Offers API
  description: Offer resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Offers
  properties:
  - type: OpenAPI
    url: openapi/bol-com-offers-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-orders-api
  name: Bol Orders API
  description: Order resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/bol-com-orders-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-products-api
  name: Bol Products API
  description: Products resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Products
  properties:
  - type: OpenAPI
    url: openapi/bol-com-products-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-promotions-api
  name: Bol Promotions API
  description: Promotions resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Promotions
  properties:
  - type: OpenAPI
    url: openapi/bol-com-promotions-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-replenishments-api
  name: Bol Replenishments API
  description: Replenishments resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Replenishments
  properties:
  - type: OpenAPI
    url: openapi/bol-com-replenishments-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-retailers-api
  name: Bol Retailers API
  description: Retailers resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Retailers
  properties:
  - type: OpenAPI
    url: openapi/bol-com-retailers-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-returns-api
  name: Bol Returns API
  description: Return resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Returns
  properties:
  - type: OpenAPI
    url: openapi/bol-com-returns-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-shipments-api
  name: Bol Shipments API
  description: Shipment resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Shipments
  properties:
  - type: OpenAPI
    url: openapi/bol-com-shipments-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-shipping-labels-api
  name: Bol Shipping Labels API
  description: Shipping labels resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Shipping Labels
  properties:
  - type: OpenAPI
    url: openapi/bol-com-shipping-labels-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-subscriptions-api
  name: Bol Subscriptions API
  description: Push notification subscriptions resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Subscriptions
  properties:
  - type: OpenAPI
    url: openapi/bol-com-subscriptions-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
- aid: bol-com:bol-com-transports-api
  name: Bol Transports API
  description: Transport resource
  humanURL: https://api.bol.com/retailer/public/Retailer-API/index.html
  baseURL: https://api.bol.com/retailer/public/
  tags:
  - Transports
  properties:
  - type: OpenAPI
    url: openapi/bol-com-transports-api-openapi.yml
  - type: JSONSchema
    url: json-schema/bol-com-retailer-offer-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-create-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-replenishment-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-update-offer-request-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-response-schema.json
  - type: JSONSchema
    url: json-schema/bol-com-subscription-request-schema.json
x-submission-probe: 301 https://www.bol.com/, 2026-10-26
x-coverage:
  state: blocked
  reason: bot-challenge
  method: derived
  generated: '2026-10-28'
  generator: derive-coverage.py (pre-flight evidence)
  detail: the company's own front door answers a browser with an anti-bot challenge, so nothing behind it is reachable by any reader
  evidence:
  - url: https://api.bol.com/mcp
    status: 403
  - url: https://bol.com/
    status: 403
x-enrichment:
  date: '2026-10-28'
  status: enriched
  artifacts_added: 39
  pass: modular-v1
  engine: identity=oss,contract=oss,surfaces=oss,docs=oss,regulatory=oss
