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.
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