Submits and updates shipment bookings to DSV across air, sea, European road and rail. Carries GS1 SSCC package tracking numbers (explicitly referenced to gs1.org/standards/id-keys/sscc), EORI numbers, HS/harmonised commodity codes, DSV MDM customer numbers and Incoterms. Returns a DSV bookingId that every other Generic API keys on.
DSV Booking API (Air, Sea, Road EU, Rail) is one of 29 APIs that DSV publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Booking, Air Freight, Ocean Freight, Road Freight, and Rail Freight. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and authentication docs.
This API exposes
7 operations
across 7 paths,
organized into 2 resource areas,
and defines 49 schemas.
It is described by OpenAPI 3.0.1, at version v2.
Requests are made against a single base URL, https://api.dsv.com/my-demo/booking/v2.
7 operations7 paths49 schemas1 GET5 POST1 PUT
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.0.1
API Version
v2
Base URL
https://api.dsv.com/my-demo/booking/v2
Authentication
API Key, API Key
Resource Areas
2
Authentication & Security 2
DSV Booking API (Air, Sea, Road EU, Rail) declares
2 security schemes
for authenticating requests.
An API key is passed in the header as DSV-Subscription-Key (apiKeyHeader).
An API key is passed in the query as DSV-Subscription-Key (apiKeyQuery).
By default, every request must be authenticated.
Paths & Operations 7
Across 7 paths, the API surfaces 7 operations — 1 GET, 5 POST, 1 PUT. They span 2 resource areas: Booking, Draft. Each is listed below with its method, path, parameters, and response codes.
The contract defines 49 schemas that model the data the API accepts and returns. The most detailed are Services (33 properties), Package (25 properties), Order (20 properties), DangerousGoods (20 properties). Each schema is shown below with its type and property counts.
DevelopmentDTO
object
Development
2 properties
ErrorDTO
object
Error
4 properties2 required
FieldDTO
object
Field
3 properties
Battery
object
Battery information
2 properties
DangerousGoods
object
This section contains the details of the dangerous goods that need to be provided to DSV to execute a booking that contains dangerous goods. This section can o…
20 properties7 required
OrderUpdates
object
This structure contains the parameters for updating packages in draft bookings
2 properties1 required
Package
object
Contains a single package line with all associated attributes like type, quantity, weight, etc.
25 properties4 required
Units
object
Defines the units of measurement (UOM) used for all measurements within the package section. It is recommended to use either all metric or all imperial UOM.
5 properties
PlaceBookingResponse
object
Contains information about submitted booking
1 property1 required
Address
object
All fields related to the address of the business partner.
13 properties
AirportSelectionService
object
The service allows to request the departure/arrival of the cargo on a specified airport. The airport UN location code is mandatory, the airport name is optiona…
2 properties
Amount
object
Represents the insurance amount
2 properties2 required
B2CService
object
2 properties
BookingParty
object
Name and address of the party that created the booking.
2 properties
Carrier
object
Name and address of the carrier
2 properties
CashOnDeliveryService
object
Request DSV to collect payment for the goods you are sending. This service can only be selected for bookings with mode of transport "Road" in some countries. P…
1 property1 required
ContactPerson
object
All fields related to Contact Person e.g. Name, Phone, email
3 properties1 required
Container
object
Specify the required containers of a certain type. Additional attributes can be submitted for certain container types. More details on container types can be f…
4 properties
CustomsClearance
object
2 properties
DateTimeRange
object
Date with time range. Used e.g., for Pickup Date and Time.
3 properties1 required
Delivery
object
Name and address of the party where shipment is delivered
2 properties
FixTimeDeliveryService
object
FreightPayer
object
Name and address of the party that receives the freight invoice. This address type is only available for product "Road". If provided for product "Air", "Sea",…
2 properties
Incoterms
object
Incoterms® describe the rights and obligations applicable between the buyer and seller of the goods being transported. They set out when transfer of liability…
2 properties2 required
InsuranceService
object
Insure your goods at DSV’s own insurance company. More information about this service can be found at https://www.dsv.com/en/our-solutions/modes-of-transport/v…
2 properties2 required
LocalTime
object
The requested pickup/delivery time (end of time window) using the 24 hours format hh:mm:ss
4 properties
Notify
object
Name and address of the party who will be notified
2 properties
Order
object
Main structure, represents the booking
20 properties4 required
OrderReference
object
References to be send along booking that can be later on used to identify linked information.
2 properties2 required
PalletExchangeService
object
Instruct DSV to exchange EUR pallets at the collection/delivery location. This service can only be selected for bookings with mode of transport “Road” in some…
2 properties2 required
Parties
object
Contains all parties involved in the booking. See the party definition section for more details.
9 properties3 required
Party
object
Reserved for future use.
3 properties1 required
Pickup
object
Name and address of the party shipment is picked up.
2 properties
PortType
object
UN Location code and Name of the departure rail terminal
2 properties1 required
PreAdviceService
object
This service will be deprecated. Please use "preAdviceMailPickUp" or "preAdviceMailDelivery"
2 properties
Product
object
Dependency rules: - If product.name = "Sea": billOfLading and containerMode are mandatory. - If product.name = "Rail": containerMode is optional; billOfLading…
6 properties1 required
RailPortSelectionService
object
The service allows to request the departure/arrival of the cargo on a specified port of loading/discharge. The UN location code is mandatory, the name is optio…
2 properties
Receiver
object
Name and address of the party receiving the shipment (consignee).
2 properties
SeaPortSelectionService
object
The service allows to request the departure/arrival of the cargo on a specified port of loading/discharge. This service can only be selected for bookings with…
2 properties
Sender
object
Name and address of the party sending the goods (shipper). If address is not already available, it will be created from supplied address data.
2 properties
Services
object
Specifies additional services that can be selected for a booking. Service availability depends on factors such as transport mode, route, and country. Some serv…
33 properties
SimpleService
object
This is a subcategory used for additional services of local agreements. Please contact your local DSV contact for more information.
1 property1 required
SpotQuoteNumberService
object
You can fill in the reference received from DSV in a spot quotation to be used for invoicing this booking.
1 property1 required
BulkBookingRequest
object
Bulk booking request containing multiple bookings
2 properties
BulkBookingResponse
object
Response for bulk booking submission containing results for each booking
4 properties
BulkBookingResult
object
Result for a single booking in bulk booking response
8 properties
LabelResponse
object
2 properties
OrderReferenceDTO
object
2 properties
SingleResponseEntityObject
object
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of DSV Booking API (Air, Sea, Road EU, Rail), published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
