DSV Draft API is one of 32 APIs that DSV publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Draft. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and authentication docs.
This API exposes
4 operations
across 4 paths,
and defines 44 schemas.
It is described by OpenAPI 3.2.0, at version v2.
Requests are made against a single base URL, https://api.dsv.com/my-demo/booking/v2.
4 operations4 paths44 schemas1 GET2 POST1 PUT
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.2.0
API Version
v2
Base URL
https://api.dsv.com/my-demo/oauth/v1
Authentication
API Key, API Key
Resource Areas
1
Authentication & Security 2
DSV Draft API 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 4
Across 4 paths, the API surfaces 4 operations — 1 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.
The contract defines 44 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.
Order
object
Main structure, represents the booking
20 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
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
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
Product
object
Dependency rules: - If product.name = "Sea": billOfLading and containerMode are mandatory. - If product.name = "Rail": containerMode is optional; billOfLading…
6 properties1 required
FieldDTO
object
Field
3 properties
Pickup
object
Name and address of the party shipment is picked up.
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
Party
object
Reserved for future use.
3 properties1 required
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
Amount
object
Represents the insurance amount
2 properties2 required
OrderReference
object
References to be send along booking that can be later on used to identify linked information.
2 properties2 required
SingleResponseEntityObject
object
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
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
Package
object
Contains a single package line with all associated attributes like type, quantity, weight, etc.
25 properties4 required
Notify
object
Name and address of the party who will be notified
2 properties
OrderUpdates
object
This structure contains the parameters for updating packages in draft bookings
2 properties1 required
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
PortType
object
UN Location code and Name of the departure rail terminal
2 properties1 required
LocalTime
object
The requested pickup/delivery time (end of time window) using the 24 hours format hh:mm:ss
4 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
Carrier
object
Name and address of the carrier
2 properties
DevelopmentDTO
object
Development
2 properties
ContactPerson
object
All fields related to Contact Person e.g. Name, Phone, email
3 properties1 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
CustomsClearance
object
2 properties
FixTimeDeliveryService
object
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
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
BookingParty
object
Name and address of the party that created the booking.
2 properties
DateTimeRange
object
Date with time range. Used e.g., for Pickup Date and Time.
3 properties1 required
PlaceBookingResponse
object
Contains information about submitted booking
1 property1 required
ErrorDTO
object
Error
4 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
Receiver
object
Name and address of the party receiving the shipment (consignee).
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
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
PreAdviceService
object
This service will be deprecated. Please use "preAdviceMailPickUp" or "preAdviceMailDelivery"
2 properties
Battery
object
Battery information
2 properties
Parties
object
Contains all parties involved in the booking. See the party definition section for more details.
9 properties3 required
Address
object
All fields related to the address of the business partner.
13 properties
Delivery
object
Name and address of the party where shipment is delivered
2 properties
B2CService
object
2 properties
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 Draft API, 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.