DSV Quote API
Requests freight quotations from DSV. Origin and destination are expressed as 5-character UN/LOCODEs for both ports and airports — the spec explicitly rejects IATA 3-letter airport codes — alongside Incoterms and dangerous-goods flags.
OpenAPI Specification
{
"openapi": "3.0.1",
"info": {
"title": "QUOTE API DEMO",
"description": "Submit a quote request",
"version": "v1"
},
"servers": [
{
"url": "https://api.dsv.com/qs-demo/quote/v1"
}
],
"paths": {
"/quotes": {
"post": {
"tags": [
"Public"
],
"summary": "Submit quote request",
"description": "Send a quote request to DSV to receive offers for Air, Sea, and Road freight",
"operationId": "Create",
"parameters": [
{
"name": "Authorization",
"in": "header",
"description": "OAuth 2.0 Bearer token. Format: Bearer <access_token>.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "DSV-Subscription-Key",
"in": "header",
"description": "Subscription key required to access the API. Provided by DSV",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/QuoteRequest"
},
"example": {
"requestedBy": {
"userId": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"language": "string",
"phone": "string"
},
"bookingParty": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
"city": "string"
},
"from": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
"city": "string"
},
"to": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
"city": "string"
},
"cargoType": "LCL",
"pickupType": "DSV",
"pickupDate": "string",
"deliveryType": "DDS",
"deliveryDate": "string",
"references": [
{
"name": "string",
"type": "Shipper reference",
"value": "TestReference1"
}
],
"insurance": {
"insuranceType": "DSVProtect",
"goodsType": "STD",
"goodsValue": {
"value": 100,
"currency": "EUR"
}
},
"packages": [
{
"id": "string",
"goodsDescription": "string",
"packageType": "BAG",
"quantity": 0,
"totalWeight": 0,
"length": 0,
"width": 0,
"height": 0,
"totalVolume": 0,
"stackable": "NotStackable",
"palletSpace": 0,
"loadMeters": 0,
"temperatureControlled": {
"minTemperature": 0,
"maxTemperature": 0
},
"dangerousGoods": [
{
"unCode": "string",
"grossWeight": 0,
"subRisk": "string",
"packingGroup": "string",
"properShippingName": "string",
"cargoAircraftOnly": true
}
],
"shippingMark": "string"
}
],
"containers": [
{
"type": "40HC",
"totalWeight": 0,
"description": "string",
"dangerousGoods": [
{
"unCode": "string",
"grossWeight": 0,
"subRisk": "string",
"packingGroup": "string",
"properShippingName": "string",
"cargoAircraftOnly": true
}
],
"temperatureControlledGoods": {
"minTemperature": 0,
"maxTemperature": 0
},
"temperatureControlledContainer": {
"genSet": true,
"temperature": 0
}
}
],
"totalWeight": 0,
"air": {
"originAirport": "string",
"destinationAirport": "string",
"batteries": "None - No battery",
"incoterms": {
"code": "EXW",
"location": "string"
},
"serviceLevel": "string",
"notes": "string"
},
"sea": {
"originPort": "string",
"destinationPort": "string",
"incoterms": {
"code": "EXW",
"location": "string"
},
"serviceLevel": "string",
"notes": "string"
},
"road": {
"incoterms": {
"code": "EXW",
"location": "string"
},
"serviceAndSurchargeCodes": [
"string"
],
"serviceLevel": "string",
"notes": "string"
},
"unitsOfMeasurement": {
"dimension": "CM",
"weight": "KG",
"volume": "M3",
"temperature": "C"
},
"source": "myDSV",
"files": [
{
"type": "INV",
"fileName": "string",
"file": "string"
}
]
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/QuoteRequest"
},
"example": {
"requestedBy": {
"userId": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"language": "string",
"phone": "string"
},
"bookingParty": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
"city": "string"
},
"from": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
"city": "string"
},
"to": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
"city": "string"
},
"cargoType": "LCL",
"pickupType": "DSV",
"pickupDate": "string",
"deliveryType": "DDS",
"deliveryDate": "string",
"references": [
{
"name": "string",
"type": "Shipper reference",
"value": "TestReference1"
}
],
"insurance": {
"insuranceType": "DSVProtect",
"goodsType": "STD",
"goodsValue": {
"value": 100,
"currency": "EUR"
}
},
"packages": [
{
"id": "string",
"goodsDescription": "string",
"packageType": "BAG",
"quantity": 0,
"totalWeight": 0,
"length": 0,
"width": 0,
"height": 0,
"totalVolume": 0,
"stackable": "NotStackable - Goods are not stackable",
"palletSpace": 0,
"loadMeters": 0,
"temperatureControlled": {
"minTemperature": 0,
"maxTemperature": 0
},
"dangerousGoods": [
{
"unCode": "string",
"grossWeight": 0,
"subRisk": "string",
"packingGroup": "string",
"properShippingName": "string",
"cargoAircraftOnly": true
}
],
"shippingMark": "string"
}
],
"containers": [
{
"type": "40HC",
"totalWeight": 0,
"description": "string",
"dangerousGoods": [
{
"unCode": "string",
"grossWeight": 0,
"subRisk": "string",
"packingGroup": "string",
"properShippingName": "string",
"cargoAircraftOnly": true
}
],
"temperatureControlledGoods": {
"minTemperature": 0,
"maxTemperature": 0
},
"temperatureControlledContainer": {
"genSet": true,
"temperature": 0
}
}
],
"totalWeight": 0,
"air": {
"originAirport": "string",
"destinationAirport": "string",
"batteries": "None - No battery",
"incoterms": {
"code": "EXW - Ex works",
"location": "string"
},
"serviceLevel": "string",
"notes": "string"
},
"sea": {
"originPort": "string",
"destinationPort": "string",
"incoterms": {
"code": "EXW",
"location": "string"
},
"serviceLevel": "string",
"notes": "string"
},
"road": {
"incoterms": {
"code": "EXW",
"location": "string"
},
"serviceAndSurchargeCodes": [
"string"
],
"serviceLevel": "string",
"notes": "string"
},
"unitsOfMeasurement": {
"dimension": "CM",
"weight": "KG",
"volume": "M3",
"temperature": "C"
},
"source": "myDSV",
"files": [
{
"type": "INV",
"fileName": "string",
"file": "string"
}
]
}
},
"application/*+json": {
"schema": {
"$ref": "#/components/schemas/QuoteRequest"
},
"example": {
"requestedBy": {
"userId": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"language": "string",
"phone": "string"
},
"bookingParty": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
"city": "string"
},
"from": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
"city": "string"
},
"to": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
"city": "string"
},
"cargoType": "LCL",
"pickupType": "DSV",
"pickupDate": "string",
"deliveryType": "DDS",
"deliveryDate": "string",
"references": [
{
"name": "string",
"type": "Shipper reference",
"value": "TestReference1"
}
],
"insurance": {
"insuranceType": "DSVProtect",
"goodsType": "STD",
"goodsValue": {
"value": 100,
"currency": "EUR"
}
},
"packages": [
{
"id": "string",
"goodsDescription": "string",
"packageType": "BAG - Bag",
"quantity": 0,
"totalWeight": 0,
"length": 0,
"width": 0,
"height": 0,
"totalVolume": 0,
"stackable": "NotStackable - Goods are not stackable",
"palletSpace": 0,
"loadMeters": 0,
"temperatureControlled": {
"minTemperature": 0,
"maxTemperature": 0
},
"dangerousGoods": [
{
"unCode": "string",
"grossWeight": 0,
"subRisk": "string",
"packingGroup": "string",
"properShippingName": "string",
"cargoAircraftOnly": true
}
],
"shippingMark": "string"
}
],
"containers": [
{
"type": "40HC",
"totalWeight": 0,
"description": "string",
"dangerousGoods": [
{
"unCode": "string",
"grossWeight": 0,
"subRisk": "string",
"packingGroup": "string",
"properShippingName": "string",
"cargoAircraftOnly": true
}
],
"temperatureControlledGoods": {
"minTemperature": 0,
"maxTemperature": 0
},
"temperatureControlledContainer": {
"genSet": true,
"temperature": 0
}
}
],
"totalWeight": 0,
"air": {
"originAirport": "string",
"destinationAirport": "string",
"batteries": "None - No battery",
"incoterms": {
"code": "EXW",
"location": "string"
},
"serviceLevel": "string",
"notes": "string"
},
"sea": {
"originPort": "string",
"destinationPort": "string",
"incoterms": {
"code": "EXW",
"location": "string"
},
"serviceLevel": "string",
"notes": "string"
},
"road": {
"incoterms": {
"code": "EXW",
"location": "string"
},
"serviceAndSurchargeCodes": [
"string"
],
"serviceLevel": "string",
"notes": "string"
},
"unitsOfMeasurement": {
"dimension": "CM",
"weight": "KG",
"volume": "M3",
"temperature": "C"
},
"source": "myDSV",
"files": [
{
"type": "INV",
"fileName": "string",
"file": "string"
}
]
}
}
}
},
"responses": {
"200": {
"description": "Quote request submitted successfully",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/QuoteResponse"
},
"example": {
"createdDate": "string",
"lastModifiedDate": "string",
"quoteRequestId": "string",
"code": "string",
"requestedBy": {
"userId": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"language": "string",
"phone": "string"
},
"requestDate": "string",
"readyForBookDate": "string",
"status": "Draft",
"bookingParty": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
"city": "string"
},
"pickupType": "DSV",
"deliveryType": "DDS",
"from": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
"city": "string"
},
"to": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
"city": "string"
},
"pickupDate": "string",
"deliveryDate": "string",
"references": [
{
"name": "string",
"type": "Shipper reference",
"value": "TestReference1"
}
],
"insurance": {
"insuranceType": "DSVProtect",
"goodsType": "STD",
"goodsValue": {
"value": 100,
"currency": "EUR"
}
},
"cargoType": "LCL",
"source": "myDSV",
"packages": [
{
"id": "string",
"goodsDescription": "string",
"packageType": "BAG",
"quantity": 0,
"totalWeight": 0,
"length": 0,
"width": 0,
"height": 0,
"totalVolume": 0,
"stackable": "NotStackable",
"palletSpace": 0,
"loadMeters": 0,
"temperatureControlled": {
"minTemperature": 0,
"maxTemperature": 0
},
"dangerousGoods": [
{
"unCode": "string",
"grossWeight": 0,
"subRisk": "string",
"packingGroup": "string",
"properShippingName": "string",
"cargoAircraftOnly": true
}
],
"shippingMark": "string"
}
],
"containers": [
{
"type": "40HC",
"totalWeight": 0,
"description": "string",
"dangerousGoods": [
{
"unCode": "string",
"grossWeight": 0,
"subRisk": "string",
"packingGroup": "string",
"properShippingName": "string",
"cargoAircraftOnly": true
}
],
"temperatureControlledGoods": {
"minTemperature": 0,
"maxTemperature": 0
},
"temperatureControlledContainer": {
"genSet": true,
"temperature": 0
}
}
],
"air": {
"originAirport": "string",
"destinationAirport": "string",
"batteries": "None",
"incoterms": {
"code": "EXW",
"location": "string"
},
"serviceLevel": "string",
"notes": "string"
},
"sea": {
"originPort": "string",
"destinationPort": "string",
"incoterms": {
"code": "EXW",
"location": "string"
},
"serviceLevel": "string",
"notes": "string"
},
"road": {
"incoterms": {
"code": "EXW",
"location": "string"
},
"serviceAndSurchargeCodes": [
"string"
],
"serviceLevel": "string",
"notes": "string"
},
"unitsOfMeasurement": {
"dimension": "CM",
"weight": "KG",
"volume": "M3",
"temperature": "C"
},
"quotes": [
{
"id": "string",
"quoteId": "string",
"code": "string",
"version": "string",
"quoteRequestId": "string",
"quoteProvider": "Air",
"status": "AvailableForCalculation",
"submissionDate": "string",
"responseDate": "string",
"validUntil": "string",
"type": "Tariff",
"modeOfTransport": "Road",
"revocationReason": "string",
"serviceLevel": "string",
"attachmentId": "string",
"price": {
"value": 0,
"currency": "string"
},
"serviceAndSurcharges": [
{
"name": "string",
"amount": {
"value": 0,
"currency": "string"
},
"id": "string",
"type": "Undefined",
"selected": true,
"productCode": "string",
"activityCode": "string",
"serviceCode": "string",
"myDSVServiceType": "string"
}
],
"manualReview": true,
"wasManualReview": true,
"validStart": "string",
"frequency": "string",
"transitTime": "string",
"scheduledDeparture": "string",
"surchargeInclusive": true,
"hideSurchargePricing": true,
"notes": "string",
"showNotes": true,
"manualReviewReason": "string",
"quoteProviderStatus": "string",
"bookingId": "string",
"quoteProviderCreatedDate": "string"
}
],
"totalWeight": 0,
"quotingCountry": "string",
"financialOwners": [
{
"modeOfTransport": "Road",
"country": "string",
"includedInRwf": true
}
],
"acceptanceDate": "string",
"reconfigurationTimestamp": "string",
"attachments": [
{
"modeOfTransport": "Road",
"attachmentId": "string",
"type": "INV",
"contentType": "string",
"fileName": "string"
}
],
"errors": [
{
"source": "string",
"code": "string",
"field": "string",
"message": "string",
"arg": {}
}
]
}
}
}
},
"400": {
"description": "Request contains not valid data or internal server error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CommandResult"
},
"example": {
"success": true,
"errors": [
{
"source": "string",
"code": "string",
"field": "string",
"message": "string",
"arg": {}
}
]
}
}
}
},
"401": {
"description": "Not authorized"
},
"403": {
"description": "Lack of privileges to use this method"
},
"404": {
"description": "Quote request not found"
}
}
}
},
"/quotes/{quoteRequestId}": {
"get": {
"tags": [
"Public"
],
"summary": "Get quote request",
"description": "Get quote request details by specifying the Quote request ID or Quote ID",
"operationId": "GetQuoteRequest",
"parameters": [
{
"name": "quoteRequestId",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "OAuth 2.0 Bearer token. Format: Bearer <access_token>.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "DSV-Subscription-Key",
"in": "header",
"description": "Subscription key required to access the API. Provided by DSV",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Quote request was returned successfully",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/QuoteResponse"
},
"example": {
"createdDate": "string",
"lastModifiedDate": "string",
"quoteRequestId": "string",
"code": "string",
"requestedBy": {
"userId": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"language": "string",
"phone": "string"
},
"requestDate": "string",
"readyForBookDate": "string",
"status": "Draft",
"bookingParty": {
"mdm": "string",
"mainMdm": "string",
"name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"country": "string",
"state": "string",
"zipCode": "string",
# --- truncated at 32 KB (123 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dsv/refs/heads/main/openapi/dsv-es-quote-demo-v1-openapi.json