Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/bol-com:bol-com-transports-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: v10 - Retailer Transports API
description: 'The bol.com API for retailers.
# Authentication
Our API requires authentication via OAuth2. The detailed steps to authenticate are explained here
# Demo scenarios
Our API specification includes examples of the responses you can expect. For more information as well as more examples, we refer you to the following resources:
- Demo environment
- Demo scenarios'
termsOfService: https://api.bol.com/retailer/public/Retailer-API/legal/terms-of-service.html
contact:
name: developers.bol.com
url: https://developers.bol.com
version: 10.x
x-logo:
url: https://api.bol.com/retailer/public/Retailer-API/_images/bolcom_logo.png
altText: bol.com logo
security:
- OAuth2: []
tags:
- name: Transports
description: Transport resource
paths:
/retailer/transports/{transport-id}:
put:
tags:
- Transports
summary: Add transport information by transport id
description: Add information to an existing transport. The transport id is part of the shipment. You can retrieve the transport id through the GET shipment list request.
operationId: add-transport-information-by-transport-id
parameters:
- name: transport-id
in: path
description: The transport id.
required: true
schema:
type: string
requestBody:
content:
application/vnd.retailer.v10+json:
schema:
$ref: '#/components/schemas/ChangeTransportRequest'
required: true
responses:
'202':
description: 'Accepted: Successfully scheduled the request for processing.'
content:
application/vnd.retailer.v10+json:
schema:
$ref: '#/components/schemas/ProcessStatus'
'400':
description: 'Bad request: The sent request does not meet the API specification. Please check the error message(s) for more information.'
content:
application/vnd.retailer.v10+json:
schema:
$ref: '#/components/schemas/Problem'
components:
schemas:
ProcessStatus:
required:
- createTimestamp
- description
- eventType
- links
- status
type: object
properties:
processStatusId:
type:
- string
- 'null'
description: The process status id.
example: '1234567'
entityId:
type:
- string
- 'null'
description: The id of the object being processed. For example, in case of a shipment process id, you will receive the id of the order item being processed.
example: '987654321'
eventType:
type: string
description: Name of the requested action that is being processed.
example: CREATE_SHIPMENT
description:
type: string
description: Describes the action that is being processed.
example: Example process status description for processing 987654321.
status:
type: string
description: Status of the action being processed.
example: SUCCESS
enum:
- PENDING
- SUCCESS
- FAILURE
- TIMEOUT
errorMessage:
type:
- string
- 'null'
description: Shows error message if applicable.
example: Example process status error message.
createTimestamp:
type: string
description: Time of creation of the response.
format: date-time
example: '2018-11-14T09:34:41+01:00'
links:
type: array
description: Lists available actions applicable to this endpoint.
items:
$ref: '#/components/schemas/Link'
ChangeTransportRequest:
required:
- trackAndTrace
type: object
properties:
transporterCode:
type:
- string
- 'null'
description: Specify the transporter that carries out the shipment.
example: TNT
trackAndTrace:
minLength: 1
type:
- string
- 'null'
description: The track and trace code that is associated with this transport.
example: 3SBOL0987654321
description: The change transport requested by the user.
Problem:
required:
- detail
- status
- title
- type
- violations
type: object
properties:
type:
type: string
description: 'Type URI for this problem. Fixed value: https://api.bol.com/problems.'
format: uri
example: https://api.bol.com/problems
title:
type: string
description: Title describing the nature of the problem.
example: Error validating request. Consult the bol.com API documentation for more information.
status:
type: integer
description: HTTP status returned from the endpoint causing the problem.
format: int32
detail:
type: string
description: Detailed error message describing in additional detail what caused the service to return this problem.
example: Bad request
host:
type:
- string
- 'null'
description: Host identifier describing the server instance that reported the problem.
example: Instance-001
instance:
type:
- string
- 'null'
description: Full URI path of the resource that reported the problem.
format: uri
example: https://api.bol.com//retailer/resource
violations:
type: array
items:
$ref: '#/components/schemas/Violation'
description: Describes a problem that occurred interacting with the API.
Violation:
required:
- name
- reason
type: object
properties:
name:
type: string
description: Describes the origin of the error, for instance a field or query parameter validation error.
example: exampleValue
reason:
type: string
description: Detailed description of the validation error that caused the problem.
example: 'Request contains invalid value(s): ''INVALID'', allowed values: ALLOWED_VALUE1, ALLOWED_VALUE2.'
description: Describes a violation that occurred interacting with the API.
Link:
type: object
properties:
href:
type: string
hreflang:
type: string
title:
type: string
type:
type: string
deprecation:
type: string
profile:
type: string
name:
type: string
templated:
type: boolean
securitySchemes:
OAuth2:
type: http
description: JWT-based access to api.bol.com
in: header
scheme: bearer