DSV Document Download API
Downloads the documents DSV holds against a booking or shipment — proof of delivery, transport documents and customs paperwork — for air, sea, European road and rail traffic.
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/dsv-document-download-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
{
"openapi": "3.0.1",
"info": {
"title": "DOWNLOAD (DEMO) - Air, Sea, Road (EU), Rail",
"description": "Download available documents for your bookings and shipments moved by DSV. Supported transport modes: Air, Sea, Road (EU), Rail and XPress.",
"version": "v1"
},
"servers": [
{
"url": "https://api.dsv.com/my-demo/download/v1"
}
],
"paths": {
"/shipments/tmsId/{tmsId}/documents": {
"get": {
"tags": [
"Shipment documents"
],
"summary": "Shipment documents by DSV Shipment ID",
"description": "Retrieve shipment's documents list by searching the DSV Shipment ID.<BR>\n<BR>\nDEMO ACCOUNT<BR><BR><I>(User email: api.demo@demo.dsv.com / Password: Demo12345)</I> <BR><BR>\nSample Shipment ID: SDFW0090209 ",
"operationId": "get-shipments-tmsid-documents",
"parameters": [
{
"name": "tmsId",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "type",
"in": "query",
"description": "Type of documents to fetch. Possible value: POD",
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "DSV Oauth header",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DocumentDto"
}
},
"example": [
{
"shipmentId": "string",
"documentId": "string",
"documentType": "string",
"typeDescription": "string",
"createDate": "string",
"fileName": "string",
"fileType": "string",
"downloadUrl": "string",
"additionalId": "string"
}
]
}
}
},
"400": {
"description": "Bad Request"
},
"404": {
"description": "Not Found"
}
}
}
},
"/shipments/bookingId/{bookingId}/documents": {
"get": {
"tags": [
"Shipment documents"
],
"summary": "Shipment documents by DSV BookingId ID",
"description": "Retrieve shipment's documents list by searching the DSV Booking ID.<BR>\n<BR>\nDEMO ACCOUNT<BR><BR><I>(User email: api.demo@demo.dsv.com / Password: Demo12345)</I> <BR><BR>\nSample Booking ID: 40288888880000190646",
"operationId": "get-shipments-bookingId-documents",
"parameters": [
{
"name": "bookingId",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "type",
"in": "query",
"description": "Type of documents to fetch. Possible value: POD",
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "DSV Oauth header",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DocumentDto"
}
},
"example": [
{
"shipmentId": "string",
"documentId": "string",
"documentType": "string",
"typeDescription": "string",
"createDate": "string",
"fileName": "string",
"fileType": "string",
"downloadUrl": "string",
"additionalId": "string"
}
]
}
}
},
"400": {
"description": "Bad Request"
},
"404": {
"description": "Not Found"
}
}
}
},
"/shipments/{shipmentId}/documents/{documentId}": {
"get": {
"tags": [
"Shipment document"
],
"summary": "Document of shipment",
"description": "Retrieve document file by shipment ID and document ID.",
"operationId": "get-shipment-shipmentId-documents-documentId",
"parameters": [
{
"name": "shipmentId",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "documentId",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "additionalId",
"in": "query",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "fileName",
"in": "query",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "DSV Oauth header",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/octet-stream": {
"schema": {
"type": "string",
"format": "binary"
},
"examples": {
"default": {
"value": null
}
}
}
}
},
"400": {
"description": "Bad Request"
},
"404": {
"description": "Not Found"
},
"500": {
"description": "Internal Server Error"
},
"512": {
"description": "Internal Server Error"
}
}
}
},
"/shipments/reference/{reference}/documents": {
"get": {
"tags": [
"Shipment documents"
],
"summary": "Shipment documents by Customer reference",
"description": "Retrieve shipment's documents list by searching the DSV Booking ID.<BR>\n<BR>\nDEMO ACCOUNT<BR><BR><I>(User email: api.demo@demo.dsv.com / Password: Demo12345)</I> <BR><BR>\nSample Customer Reference: XXX",
"operationId": "get-shipments-reference-documents",
"parameters": [
{
"name": "reference",
"in": "path",
"description": "Reference",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "type",
"in": "query",
"description": "Type of documents to fetch. Possible value: POD",
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "DSV Oauth header",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DocumentDto"
}
},
"example": [
{
"shipmentId": "string",
"documentId": "string",
"documentType": "string",
"typeDescription": "string",
"createDate": "string",
"fileName": "string",
"fileType": "string",
"downloadUrl": "string",
"additionalId": "string"
}
]
}
}
},
"400": {
"description": "Bad Request"
},
"404": {
"description": "Not Found"
}
}
}
}
},
"components": {
"schemas": {
"DocumentDto": {
"type": "object",
"properties": {
"shipmentId": {
"type": "string",
"description": "Identifier of the shipment"
},
"documentId": {
"type": "string",
"description": "Identifier of the document"
},
"documentType": {
"type": "string",
"description": "Type of the document"
},
"typeDescription": {
"type": "string",
"description": "Description of the document's type"
},
"createDate": {
"type": "string",
"description": "Document's upload date",
"format": "date"
},
"fileName": {
"type": "string",
"description": "Name of the file"
},
"fileType": {
"type": "string",
"description": "Type of the file"
},
"downloadUrl": {
"type": "string",
"description": "Url for file download"
},
"additionalId": {
"type": "string",
"description": "Document additional ID"
}
}
}
},
"securitySchemes": {
"apiKeyHeader": {
"type": "apiKey",
"name": "DSV-Subscription-Key",
"in": "header"
},
"apiKeyQuery": {
"type": "apiKey",
"name": "DSV-Subscription-Key",
"in": "query"
}
}
},
"security": [
{
"apiKeyHeader": []
},
{
"apiKeyQuery": []
}
]
}