Polling track-and-trace over DSV-moved shipments. Lookups by DSV bookingId, DSV TMS shipment id or customer reference; responses carry house and master bill of lading numbers, air waybill numbers, container numbers, UN/LOCODE locations, SSCC package numbers, carrier SCAC codes and a DSV-proprietary event vocabulary.
{
"openapi": "3.0.1",
"info": {
"title": "TRACKING (DEMO)- Air, Sea, Road (EU), Rail",
"description": "Submit trackings to DSV via the tracking API. Supported transport modes: Air, Sea, Road (EU) and Rail.",
"version": "v2"
},
"servers": [
{
"url": "https://api.dsv.com/my-demo/tracking/v2"
}
],
"paths": {
"/shipments/list": {
"post": {
"tags": [
"Shipment list"
],
"summary": "Shipment list",
"description": "Retrieve a list of shipments for a specific period, transport mode or shipment status.<BR><BR>\nDEMO ACCOUNT<BR>\nAuthorization: client_id: api.demo@demo.dsv.com, client_secret: Demo12345</I> ",
"operationId": "listPost",
"parameters": [
{
"name": "Authorization",
"in": "header",
"description": "DSV Oauth header",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ListParamsDTO"
},
"example": "ListParams"
}
}
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ShipmentSummaryAPI"
}
},
"example": [
{
"mainTmsShipmentId": "string",
"shipmentId": "string",
"bookingId": "string",
"carrierTrackingId": "string",
"parties": {
"sender": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"receiver": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"delivery": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"pickup": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
}
},
"fromDate": "string",
"toDate": "string",
"SubmodeOfTransport": "string",
"status": "Draft",
"references": [
{
"type": "string",
"value": "string"
}
],
"bookedBy": "string",
"incoTerms": "string",
"incoTermsLocation": "string",
"goods": {
"totalColli": 0,
"totalWeight": 0,
"totalVolume": 0,
"totalLoadMeters": 0
},
"requestedPickup": "string",
"actualPickup": "string",
"requestedDelivery": "string",
"actualDelivery": "string",
"barcode": "string",
"barcodeLatestEvent": "string",
"fromDateType": "Booking",
"fromDateStart": "string",
"fromDateEnd": "string",
"toDateType": "Booking",
"toDateStart": "string",
"toDateEnd": "string"
}
]
}
}
}
}
}
},
"/shipments/bookingId/{bookingId}": {
"get": {
"tags": [
"Shipment details"
],
"summary": "Shipment details by DSV Booking ID",
"description": "Retrieve detailed shipment data for a specific shipment by searching the DSV booking ID received from API booking or bookings submitted via myDSV.<BR>\n<BR>\nAuthorization: client_id: api.demo@demo.dsv.com, client_secret: Demo12345</I> <BR><BR>\nSample Booking IDs: 40257145990010760574, 40257145990010760581 ",
"operationId": "getShipmentByBookingId",
"parameters": [
{
"name": "bookingId",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "DSV Oauth header",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ShipmentDetailsAPI"
},
"example": {
"bookingId": "string",
"shipmentId": "string",
"masterShipmentId": "string",
"childShipmentIds": [
"string"
],
"status": "string",
"product": {
"name": "Sea",
"billOfLading": "Original",
"containerMode": "FCL",
"containers": [
{
"ref": "TestContainerNumber1",
"type": "20RE",
"genset": true,
"temp": -20
}
],
"dropOff": false,
"subModeOfTransport": "FSA"
},
"parties": {
"sender": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"receiver": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"delivery": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"pickup": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"notify": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"freightPayer": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"bookingParty": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"carrier": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"party": [
{
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
},
"role": "string"
}
]
},
"dateTime": {
"pickupTime": {
"date": "2020-08-30",
"start": "2023-08-07",
"end": "2023-08-07"
},
"deliveryTime": {
"date": "2020-08-30",
"start": "2023-08-07",
"end": "2023-08-07"
}
},
"references": [
{
"type": "string",
"value": "string"
}
],
"bookedBy": "string",
"events": [
{
"eventDate": "string",
"eventGroup": "string",
"eventCode": "string",
"eventDescription": "string",
"eventType": "string",
"eventTypeValue": "string",
"location": {
"countryCode": "string",
"unlocode": "string",
"place": "string"
},
"transportMode": "string",
"vesselName": "string",
"voyageId": "string"
}
],
"packages": [
{
"stackable": {},
"length": 0,
"lengthUOM": "string",
"loadingMeters": 0,
"palletSpace": 0,
"grossWeight": 0,
"netWeight": 0,
"quantity": 0,
"totalVolume": 0,
"volumeUOM": "string",
"totalWeight": 0,
"width": 0,
"widthUOM": "string",
"height": 0,
"heightUOM": "string",
"packageType": "BAG",
"temperatureMin": 0,
"temperatureMax": 0,
"description": "string",
"shippingMarks": "string",
"isDangerous": true,
"dangerous": [
{
"className": "string",
"subRisk": "string",
"flashPoint": 0,
"limitedQuantity": true,
"marinePollutant": true,
"packingGroup": "string",
"properShippingName": "string",
"technicalName": "string",
"technicalNameNational": "string",
"temperatureFrom": 0,
"temperatureTo": 0,
"type": "string",
"unCode": 0,
"tunnelCode": "string",
"packagesCount": 0,
"packingKind": "BAG",
"netQuantity": 0,
"netQuantityUnit": "KG",
"grossQuantity": 0,
"grossQuantityUnit": "KG",
"empty": true
}
],
"containerNo": "MAEU7654213",
"trackingNumbers": [
"string"
],
"cargoAircraftOnly": true,
"temperatureControlled": true,
"goodsType": "string",
"references": [
{
"reference": "string",
"qualifier": "string"
}
]
}
],
"transport": {
"houseBillNumber": "string",
"masterBillNumber": "string",
"awb": "string",
"originName": "string",
"originCode": "string",
"destinationName": "string",
"destinationCode": "string"
},
"containers": [
{
"containerNumber": "string",
"containerType": "string",
"sealNumber": "string"
}
],
"deliveryInstructions": "string",
"pickupInstructions": "string",
"shipmentNotes": "string",
"incoterms": {
"code": "string",
"location": "string"
},
"serviceLevel": {
"code": "string",
"description": "string"
},
"goods": {
"grossWeightUom": "string",
"grossWeightValue": 0,
"loadingMetersUom": "string",
"loadingMetersValue": 0,
"quantityUom": "string",
"quantityValue": 0,
"volumeUom": "string",
"volumeValue": 0,
"description": "string"
},
"issues": [
{
"issueDate": "string",
"issuePointCode": "string",
"issuePointDescription": "string",
"issuePartyCode": "string",
"issuePartyDescription": "string",
"issueTypeCode": "string",
"issueTypeDescription": "string",
"issueReasonCode": "string",
"issueReasonDescription": "string",
"issueNotes": "string",
"issueResolved": "string"
}
],
"publicShipmentId": "string",
"carrierTrackingId": "string",
"proofsOfDelivery": [
{
"documentId": "string",
"documentType": "string",
"typeDescription": "string",
"createDate": "string",
"fileName": "string",
"fileType": "string",
"downloadUrl": "string"
}
],
"selectedServices": [
{
"name": "string",
"code": "string",
"details": {}
}
],
"customs": {
"shippedOnboardDate": "string",
"customsStatus": "string",
"entryNumber": [
"string"
],
"forwarder": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"removalMode": "string"
}
}
}
}
},
"400": {
"description": "Bad request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorDTO"
},
"example": {
"code": "ERR12345",
"message": "Not found booking: 40257145990010785188",
"fields": [
{
"name": "field_name",
"message": "validation error",
"code": "ERR12345"
}
],
"development": {
"message": "string",
"exception": "string"
}
}
}
}
},
"404": {
"description": "Not found",
"content": {
"*/*": {
"schema": {
"type": "object"
},
"examples": {
"default": {
"value": null
}
}
}
}
}
}
}
},
"/shipments/tmsId/{tmsId}": {
"get": {
"tags": [
"Shipment details"
],
"summary": "Shipment details by DSV Shipment ID",
"description": "Retrieve detailed shipment data for a specific shipment by searching the DSV Shipment ID.<BR>\n<BR>\nDEMO ACCOUNT<BR>Authorization: client_id: api.demo@demo.dsv.com, client_secret: Demo12345</I> <BR><BR>\nSample TMS IDs: SDSV0069726, SDSV0069727, SDFW0090209 ",
"operationId": "getShipmentByTmsId",
"parameters": [
{
"name": "tmsId",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "DSV Oauth header",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ShipmentDetailsAPI"
},
"example": {
"bookingId": "string",
"shipmentId": "string",
"masterShipmentId": "string",
"childShipmentIds": [
"string"
],
"status": "string",
"product": {
"name": "Sea",
"billOfLading": "Original",
"containerMode": "FCL",
"containers": [
{
"ref": "TestContainerNumber1",
"type": "20RE",
"genset": true,
"temp": -20
}
],
"dropOff": false,
"subModeOfTransport": "FSA"
},
"parties": {
"sender": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"receiver": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"delivery": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]",
"zipCode": "1234",
"instructions": "Specific Address Party Instrution",
"mdm": "6412345678"
},
"contact": {
"name": "Test Name",
"email": "testemail@testcompany.com",
"telephone": "+4512345678"
}
},
"pickup": {
"address": {
"companyName": "Test Company Name Inc.",
"addressId": "AddressID123",
"addressLine1": "Test Address Line 1",
"addressLine2": "Test Address Line 2",
"addressLine3": "string",
"city": "Test Address City",
"countryCode": "DK",
"state": "range[-infinity, 40]"
# --- truncated at 32 KB (147 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dsv/refs/heads/main/openapi/dsv-generic-tracking-demo-v2-openapi.json