DSV XPress Tracking API
Express/parcel track-and-trace. Shipments are addressable by DSV shipment id or by air waybill number (GET /shipments/awb/{awb}); responses carry the underlying express carrier's own tracking number and tracking URL.
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-xpress-tracking-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": "Tracking - XPress",
"description": "Track the status and latest events of your bookings and shipments moved by DSV.",
"version": "v2"
},
"servers": [
{
"url": "https://api.dsv.com/xp/tracking/v2"
}
],
"paths": {
"/shipmentDetails/{shipmentId}": {
"get": {
"tags": [
"Shipment"
],
"summary": "Shipment details by DSV Shipment ID",
"description": "Retrieve detailed information for a specific shipment by searching for the DSV Shipment Id. (e.g. shipment addresses, service, pieces, weight, volume, revenue, references, ETA)",
"operationId": "getShipment",
"parameters": [
{
"name": "shipmentId",
"in": "path",
"description": "ID of shipment to get details",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "dsv-service-auth",
"in": "header",
"description": "DSV XPress service auth for the selected API (found on DSV XPress API profile page)",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-pat",
"in": "header",
"description": "DSV XPress personal access token (found on DSV XPress API profile page)",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ShipmentResponse"
},
"example": {
"shipment": {
"shipmentId": 10123456,
"dsvAccount": "6400000000",
"trackingUrl": "https://tracking-url.dsv.com/#/track-shipment?id=10123456",
"etaDate": "2020-03-19",
"sender": {
"companyName": "DSV A/S",
"addressLine1": "Hovedgaden 630",
"zipCode": "2640",
"city": "Hedehusene",
"countryCode": "DK",
"contactName": "Sender contact",
"contactPhoneNumber": "+45 123456789",
"contactEmail": "john.smith@sender.com"
},
"receiver": {
"companyName": "DSV Air & Sea GmbH",
"addressLine1": "Nirostastra\u00dfe 3",
"zipCode": "47807",
"city": "Krefeld",
"countryCode": "DE",
"contactName": "Receiver contact",
"contactPhoneNumber": "+44 123456789",
"contactEmail": "robert.smith@receiver.com"
},
"pickup": {
"collectDateFrom": "2020-03-17T02:00:00.0000000+00:00",
"collectDateTo": "2020-03-17T06:00:00.0000000+00:00",
"address": {
"companyName": "DSV A/S",
"addressLine1": "Hovedgaden 630",
"zipCode": "2640",
"city": "Hedehusene",
"countryCode": "DK",
"contactName": "Sender contact",
"contactPhoneNumber": "+45 123456789",
"contactEmail": "john.smith@sender.com"
}
},
"delivery": {
"companyName": "DSV Air & Sea GmbH",
"addressLine1": "Nirostastra\u00dfe 3",
"zipCode": "47807",
"city": "Krefeld",
"countryCode": "DE",
"contactName": "Receiver contact",
"contactPhoneNumber": "+44 123456789",
"contactEmail": "robert.smith@receiver.com"
},
"serviceOptions": {
"packageType": "PARCELS",
"serviceCode": "DSVAirExpress",
"insurance": {
"currencyCode": "DKK",
"monetaryValue": 2000
}
},
"carrier": {
"carrierCode": "Fedex",
"serviceCode": "INTERNATIONAL_PRIORITY"
},
"dimensionUnit": "CM",
"weightUnit": "KG",
"volumeUnit": "M3",
"packages": [
{
"length": 50,
"width": 40,
"height": 40,
"grossWeight": 6.5,
"volume": 0.08,
"chargeableWeight": 6.5
}
],
"commodities": [
{
"originCountryCode": "DK",
"goodsDescription": "samples",
"goodsValue": {
"currencyCode": "DKK",
"monetaryValue": 1000
}
}
],
"paymentInformation": {
"shippingChargesPayment": {
"paymentType": "SENDER"
},
"dutiesAndTaxesPayment": {
"paymentType": "RECEIVER"
}
},
"billedCharges": {
"freight": [
{
"code": "24",
"description": "Courrier shipment",
"currencyCode": "EUR",
"monetaryValue": 30.15,
"debtorAccountID": "6400000000",
"debtorCompanyName": "DSV A/S"
}
],
"fuel": [
{
"code": "1",
"description": "Fuel Surcharge ",
"currencyCode": "EUR",
"monetaryValue": 36,
"debtorAccountID": "6400000000",
"debtorCompanyName": "DSV A/S"
}
],
"otherCharges": [
{
"code": "30",
"description": "Insurance",
"currencyCode": "EUR",
"monetaryValue": 3,
"debtorAccountID": "6400000000",
"debtorCompanyName": "DSV A/S"
},
{
"code": "67",
"description": "Customs Inspection",
"currencyCode": "EUR",
"monetaryValue": 52,
"debtorAccountID": "6400000000",
"debtorCompanyName": "DSV A/S"
},
{
"code": "19",
"description": "Domestic 12:00AM Delivery",
"currencyCode": "EUR",
"monetaryValue": 16.33,
"debtorAccountID": "6400000000",
"debtorCompanyName": "DSV A/S"
}
],
"total": {
"currencyCode": "EUR",
"monetaryValue": 137.48
}
},
"estimatedCharges": {
"otherCharges": [
{
"code": "25",
"description": "Administration Fee",
"currencyCode": "EUR",
"monetaryValue": 27,
"debtorAccountID": "6400000000",
"debtorCompanyName": "DSV A/S"
}
],
"total": {
"currencyCode": "EUR",
"monetaryValue": 27
}
}
}
}
}
}
},
"400": {
"description": "Invalid ID supplied"
},
"401": {
"description": "Unauthorized"
},
"404": {
"description": "Shipment not found"
}
}
}
},
"/shipments/shipmentId/{shipmentId}": {
"get": {
"tags": [
"Tracking"
],
"summary": "Events by DSV Shipment ID",
"description": "Retrieve actual events for a specific shipment by searching for the DSV Shipment Id. (e.g. actual departure, transit events, exception events, actual delivery etc.)",
"operationId": "trackShipment",
"parameters": [
{
"name": "shipmentId",
"in": "path",
"description": "ID of shipment to track",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "dsv-service-auth",
"in": "header",
"description": "DSV XPress service auth for the selected API (found on DSV XPress API profile page)",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-pat",
"in": "header",
"description": "DSV XPress personal access token (found on DSV XPress API profile page)",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation. Return the list of shipment events.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TrackingResponse"
},
"example": {
"shipmentId": 10123456,
"carrierTrackingNumber": "1Z3E123412345678",
"trackingUrl": "https://tracking-url.dsv.com/#/track-shipment?id=10123456",
"trackingStatus": "DELIVERED",
"pickupDate": "2020-02-25T09:57:28.0000000+00:00",
"delivery": {
"deliveryDate": "2020-02-26T09:38:06.0000000+00:00",
"deliverySignature": "SMITH",
"deliveryLocation": "Dock"
},
"events": [
{
"eventCode": "KB",
"deviationCode": "D",
"eventDate": "2020-02-26T09:38:06.0000000+00:00",
"eventDescription": "Delivered (Signed by : SMITH)",
"location": "NL-AMERSFOORT",
"deliverySignature": "SMITH",
"deliveryLocation": "Dock",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "OF",
"deviationCode": "I",
"eventDate": "2020-02-26T04:46:00.0000000+00:00",
"eventDescription": "Out For Delivery",
"location": "NL-Apeldoorn",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "AR",
"deviationCode": "I",
"eventDate": "2020-02-26T04:45:00.0000000+00:00",
"eventDescription": "Arrival Scan",
"location": "NL-Apeldoorn",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "DP",
"deviationCode": "I",
"eventDate": "2020-02-26T02:55:00.0000000+00:00",
"eventDescription": "Departure Scan",
"location": "DE-Herne-Boernig",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "AR",
"deviationCode": "I",
"eventDate": "2020-02-26T01:21:00.0000000+00:00",
"eventDescription": "Arrival Scan",
"location": "DE-Herne-Boernig",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "DP",
"deviationCode": "I",
"eventDate": "2020-02-25T09:15:00.0000000+00:00",
"eventDescription": "Departure Scan",
"location": "DE-Hamburg",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "DP",
"deviationCode": "I",
"eventDate": "2020-02-25T06:45:00.0000000+00:00",
"eventDescription": "Departure Scan",
"location": "DE-Reinfeld",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "OR",
"deviationCode": "I",
"eventDate": "2020-02-25T05:40:47.0000000+00:00",
"eventDescription": "Origin Scan",
"location": "DE-Reinfeld",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "MP",
"deviationCode": "M",
"eventDate": "2020-02-25T03:15:55.0000000+00:00",
"eventDescription": "Order Processed: Ready for UPS",
"location": "DE",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "PRS",
"eventDate": "2020-02-25T09:57:28.0000000+00:00",
"eventDescription": "Shipment submited",
"eventType": "S",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "DSVXPRESS"
},
{
"eventCode": "PRC",
"eventDate": "2020-02-25T09:57:16.0000000+00:00",
"eventDescription": "Shipment created",
"eventType": "S",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "DSVXPRESS"
}
]
}
}
}
},
"400": {
"description": "Invalid ID supplied"
},
"401": {
"description": "Unauthorized"
},
"404": {
"description": "Shipment not found"
}
}
}
},
"/shipments/carrierTrackingNumber/{carrierTrackingNumber}": {
"get": {
"tags": [
"Tracking"
],
"summary": "Events by Carrier tracking number",
"description": "Retrieve actual events for a specific shipment by searching for the Carrier tracking id. (e.g. actual departure, transit events, exception events, actual delivery etc.)",
"operationId": "trackShipmentByCarrierTrackingNumber",
"parameters": [
{
"name": "carrierTrackingNumber",
"in": "path",
"description": "Carrier tracking number of shipment to track",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "dsv-service-auth",
"in": "header",
"description": "DSV XPress service auth for the selected API (found on DSV XPress API profile page)",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-pat",
"in": "header",
"description": "DSV XPress personal access token (found on DSV XPress API profile page)",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation. Return the list of shipment events.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TrackingResponse"
},
"example": {
"shipmentId": 10123456,
"carrierTrackingNumber": "1Z3E123412345678",
"trackingUrl": "https://tracking-url.dsv.com/#/track-shipment?id=10123456",
"trackingStatus": "DELIVERED",
"pickupDate": "2020-02-25T09:57:28.0000000+00:00",
"delivery": {
"deliveryDate": "2020-02-26T09:38:06.0000000+00:00",
"deliverySignature": "SMITH",
"deliveryLocation": "Dock"
},
"events": [
{
"eventCode": "KB",
"deviationCode": "D",
"eventDate": "2020-02-26T09:38:06.0000000+00:00",
"eventDescription": "Delivered (Signed by : SMITH)",
"location": "NL-AMERSFOORT",
"deliverySignature": "SMITH",
"deliveryLocation": "Dock",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "OF",
"deviationCode": "I",
"eventDate": "2020-02-26T04:46:00.0000000+00:00",
"eventDescription": "Out For Delivery",
"location": "NL-Apeldoorn",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "AR",
"deviationCode": "I",
"eventDate": "2020-02-26T04:45:00.0000000+00:00",
"eventDescription": "Arrival Scan",
"location": "NL-Apeldoorn",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "DP",
"deviationCode": "I",
"eventDate": "2020-02-26T02:55:00.0000000+00:00",
"eventDescription": "Departure Scan",
"location": "DE-Herne-Boernig",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "AR",
"deviationCode": "I",
"eventDate": "2020-02-26T01:21:00.0000000+00:00",
"eventDescription": "Arrival Scan",
"location": "DE-Herne-Boernig",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "DP",
"deviationCode": "I",
"eventDate": "2020-02-25T09:15:00.0000000+00:00",
"eventDescription": "Departure Scan",
"location": "DE-Hamburg",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "DP",
"deviationCode": "I",
"eventDate": "2020-02-25T06:45:00.0000000+00:00",
"eventDescription": "Departure Scan",
"location": "DE-Reinfeld",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "OR",
"deviationCode": "I",
"eventDate": "2020-02-25T05:40:47.0000000+00:00",
"eventDescription": "Origin Scan",
"location": "DE-Reinfeld",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "MP",
"deviationCode": "M",
"eventDate": "2020-02-25T03:15:55.0000000+00:00",
"eventDescription": "Order Processed: Ready for UPS",
"location": "DE",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "PRS",
"eventDate": "2020-02-25T09:57:28.0000000+00:00",
"eventDescription": "Shipment submited",
"eventType": "S",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "DSVXPRESS"
},
{
"eventCode": "PRC",
"eventDate": "2020-02-25T09:57:16.0000000+00:00",
"eventDescription": "Shipment created",
"eventType": "S",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "DSVXPRESS"
}
]
}
}
}
},
"400": {
"description": "Invalid carrier tracking number supplied"
},
"401": {
"description": "Unauthorized"
},
"404": {
"description": "Shipment not found"
}
}
}
},
"/shipments/awb/{awb}": {
"get": {
"tags": [
"Tracking"
],
"summary": "Events by AWB number",
"description": "Retrieve actual events for a specific shipment by searching for the AWB number. (e.g. actual departure, transit events, exception events, actual delivery etc.)",
"operationId": "trackShipmentByAwb",
"parameters": [
{
"name": "awb",
"in": "path",
"description": "AWB of shipment to track",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "dsv-service-auth",
"in": "header",
"description": "DSV XPress service auth for the selected API (found on DSV XPress API profile page)",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-pat",
"in": "header",
"description": "DSV XPress personal access token (found on DSV XPress API profile page)",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "successful operation. Return the list of shipment events.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TrackingResponse"
},
"example": {
"shipmentId": 10123456,
"carrierTrackingNumber": "1Z3E123412345678",
"trackingUrl": "https://tracking-url.dsv.com/#/track-shipment?id=10123456",
"trackingStatus": "DELIVERED",
"pickupDate": "2020-02-25T09:57:28.0000000+00:00",
"delivery": {
"deliveryDate": "2020-02-26T09:38:06.0000000+00:00",
"deliverySignature": "SMITH",
"deliveryLocation": "Dock"
},
"events": [
{
"eventCode": "KB",
"deviationCode": "D",
"eventDate": "2020-02-26T09:38:06.0000000+00:00",
"eventDescription": "Delivered (Signed by : SMITH)",
"location": "NL-AMERSFOORT",
"deliverySignature": "SMITH",
"deliveryLocation": "Dock",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "OF",
"deviationCode": "I",
"eventDate": "2020-02-26T04:46:00.0000000+00:00",
"eventDescription": "Out For Delivery",
"location": "NL-Apeldoorn",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "AR",
"deviationCode": "I",
"eventDate": "2020-02-26T04:45:00.0000000+00:00",
"eventDescription": "Arrival Scan",
"location": "NL-Apeldoorn",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "DP",
"deviationCode": "I",
"eventDate": "2020-02-26T02:55:00.0000000+00:00",
"eventDescription": "Departure Scan",
"location": "DE-Herne-Boernig",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "AR",
"deviationCode": "I",
"eventDate": "2020-02-26T01:21:00.0000000+00:00",
"eventDescription": "Arrival Scan",
"location": "DE-Herne-Boernig",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "DP",
"deviationCode": "I",
"eventDate": "2020-02-25T09:15:00.0000000+00:00",
"eventDescription": "Departure Scan",
"location": "DE-Hamburg",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "DP",
"deviationCode": "I",
"eventDate": "2020-02-25T06:45:00.0000000+00:00",
"eventDescription": "Departure Scan",
"location": "DE-Reinfeld",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "OR",
"deviationCode": "I",
"eventDate": "2020-02-25T05:40:47.0000000+00:00",
"eventDescription": "Origin Scan",
"location": "DE-Reinfeld",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "MP",
"deviationCode": "M",
"eventDate": "2020-02-25T03:15:55.0000000+00:00",
"eventDescription": "Order Processed: Ready for UPS",
"location": "DE",
"eventType": "P",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "UPS"
},
{
"eventCode": "PRS",
"eventDate": "2020-02-25T09:57:28.0000000+00:00",
"eventDescription": "Shipment submited",
"eventType": "S",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "DSVXPRESS"
},
{
"eventCode": "PRC",
"eventDate": "2020-02-25T09:57:16.0000000+00:00",
"eventDescription": "Shipment created",
"eventType": "S",
"carrierTrackingNumber": "1Z3E123412345678",
"source": "DSVXPRESS"
}
]
}
}
}
},
"400": {
"description": "Invalid AWB number supplied"
},
"401": {
"description": "Unauthorized"
},
"404": {
"description": "Shipment not found"
}
}
}
}
},
"components": {
"schemas": {
"ErrorItem": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"details": {
"type": "string"
}
}
},
"TrackingResponse": {
"properties": {
"errors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ErrorItem"
}
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ErrorItem"
}
},
"shipmentId": {
"type": "integer",
"description": "DSV Shipment ID",
"format": "int32"
},
"carrierTrackingNumber": {
"type": "string",
"description": "Shipment carrier tracking number"
},
"awb": {
"type": "string",
"description": "Shipment AirWay Bill number"
},
"trackingUrl": {
"type": "string",
"description": "Tracking URL"
# --- truncated at 32 KB (89 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dsv/refs/heads/main/openapi/dsv-xpress-tracking-v2-openapi.json