DSV

DSV Booking API

Booking Api Service

Documentation GitHub OpenAPI

Operations 8

POST /bookings 1. Submit booking #

POST /bookings/validate 2. Validate booking #

GET /bookings/getLabel/{bookingId}/{sscc} 6. Get labels by bookingId and SSCC #

POST /bookings/bulk 7. Submit bulk bookings #

POST /bookings/uploadDocument 2. Upload documents to draft booking (Deprecated) #

POST /bookings/uploadDocument/{shipmentId} 2. Upload documents to draft booking #

GET /bookings/labels/{shipmentId} 3. Confirm booking & download labels #

DELETE /bookings/cancel/{shipmentId} 4. Cancel submitted booking #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/dsv-booking-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Dsv Booking API
  version: v2
  description: 'Operations tagged Booking across 2 of this provider''s published API definitions: dsv-generic-booking-demo-v2-openapi.json, dsv-xpress-booking-v2-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.dsv.com/my-demo/booking/v2
- url: https://api.dsv.com/xp/booking/v2
security:
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: Booking
  description: Booking Api Service
paths:
  /bookings:
    post:
      tags:
      - Booking
      summary: 1. Submit booking
      description: Submit a real transport booking to DSV to move a package from A to B.
      operationId: placeBooking
      parameters:
      - name: labelType
        in: query
        description: 'These are the supported label types

          - pdf

          - zpl


          If a "labelType" is not added to the request the label response will default to "pdf"'
        schema:
          enum:
          - pdf
          - zpl
          type: string
          default: pdf
      - name: printFormat
        in: query
        description: 'These are the supported print formats

          - Landscape

          - Portrait


          If a "printFormat" is not added to the request the label response will default to "Landscape"'
        schema:
          enum:
          - Landscape
          - Portrait
          type: string
          default: Landscape
      - name: Authorization
        in: header
        description: OAuth header
        required: true
        schema:
          type: string
      - name: DSV-Subscription-Key
        in: header
        description: DSV Subscription Key
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/Road-json:
            schema:
              $ref: '#/components/schemas/Order'
            example:
              autobook: true
              labelRequest: false
              product:
                name: Road
              services:
                insurance:
                  amount:
                    value: 100
                    currency: DKK
                  category: STD
              incoterms:
                code: EXW
                location: TestCityPickup1
              pickupTime:
                date: '2025-03-15'
              deliveryTime:
                date: '2025-03-19'
              pickupInstructions:
              - Test Pickup instruction
              deliveryInstructions:
              - Test Delivery instruction
              parties:
                sender:
                  address:
                    companyName: Test-Sender1
                    addressId: Test1
                    addressLine1: Test address 1
                    addressLine2: Test address 1.2
                    addressLine3: null
                    city: TestCity1
                    countryCode: DK
                    state: null
                    zipCode: '0000'
                    instructions: null
                    mdm: null
                  contact:
                    name: Test Name
                    email: testemail@testemail.com
                    telephone: '+4512345678'
                receiver:
                  address:
                    companyName: Test-Receiver1
                    addressId: Test2
                    addressLine1: Test address 1
                    addressLine2: Test address 1.2
                    addressLine3: null
                    city: TestCity2
                    countryCode: US
                    state: NY
                    zipCode: '000000'
                    instructions: null
                    mdm: null
                  contact:
                    name: Test name 1
                    email: testemail1@emailtest.com
                    telephone: '+11234567890'
                delivery:
                  address:
                    companyName: Test-Delivery1
                    addressId: TestDelivery1
                    addressLine1: Test address delivery 1
                    addressLine2: Test address delivery 1.2
                    addressLine3: null
                    city: TestCityDelivery1
                    countryCode: US
                    state: NY
                    zipCode: '00000'
                    instructions: null
                    mdm: null
                  contact:
                    name: TestName
                    email: testemail3@emailtest.com
                    telephone: '+112345678901'
                pickup:
                  address:
                    companyName: Test-Pickup1
                    addressId: TestPickup1
                    addressLine1: Test address pickup 1
                    addressLine2: Test address pickup 1.2
                    addressLine3: null
                    city: TestCityPickup1
                    countryCode: DK
                    state: null
                    zipCode: '0000'
                    instructions: null
                    mdm: null
                  contact:
                    name: TestName
                    email: testemail2@emailtest.com
                    telephone: '+451234567890'
                freightPayer:
                  address:
                    mdm: '**Add your Demo MDM**'
                bookingParty:
                  address:
                    mdm: '**Add your Demo MDM**'
              packages:
              - quantity: 1
                packageType: BAG
                totalWeight: 1500
                netWeight: 1000
                length: 60
                height: 80
                width: 70
                stackable: STACKABLE
                totalVolume: 0.336
                palletSpace: null
                loadingMeters: 2
                description: Test goods 1
                shippingMarks: Test shipping marks 1
              - quantity: 2
                packageType: BAG
                totalWeight: 1200
                netWeight: 800
                length: 30
                height: 50
                width: 40
                stackable: 'NO'
                totalVolume: 0.12
                palletSpace: null
                loadingMeters: 1
                description: Test goods 2
                shippingMarks: Test shipping marks 2
              references:
              - value: TestReference1
                type: INVOICING_REFERENCE
              - value: TestReference2
                type: ORDER_NUMBER
              - value: TestReference3
                type: CONSIGNEE_REFERENCE
              - value: TestReference4
                type: SHIPPER_REFERENCE
              - value: TestReference5
                type: OTHER
              units:
                dimension: CM
                weight: KG
                volume: M3
                loadingSpace: LM
                temperature: C
          application/Air-json:
            schema:
              $ref: '#/components/schemas/Order'
            example:
              autobook: true
              labelRequest: false
              product:
                name: Air
                dropOff: false
              services:
                insurance:
                  amount:
                    value: 1500
                    currency: USD
                  category: STD
                airportSelection:
                  airportOfDeparture:
                    code: USJFK
                    name: John F. Kennedy Apt/New York
                  airportOfDestination:
                    code: GBLHR
                    name: Heathrow Apt/London
              incoterms:
                code: EXW
                location: TestCityPickup1
              pickupTime:
                date: '2025-03-15'
              deliveryTime:
                date: '2025-03-19'
              pickupInstructions:
              - Test Pickup instruction
              deliveryInstructions:
              - Test Delivery instruction
              parties:
                sender:
                  address:
                    companyName: Test-Sender1
                    addressId: Test1
                    addressLine1: Test address 1
                    addressLine2: Test address 1.2
                    addressLine3: null
                    city: TestCity1
                    countryCode: DK
                    state: null
                    zipCode: '0000'
                    instructions: null
                    mdm: null
                  contact:
                    name: Test Name
                    email: testemail@testemail.com
                    telephone: '+4512345678'
                receiver:
                  address:
                    companyName: Test-Receiver1
                    addressId: Test2
                    addressLine1: Test address 1
                    addressLine2: Test address 1.2
                    addressLine3: null
                    city: TestCity2
                    countryCode: US
                    state: NY
                    zipCode: '000000'
                    instructions: null
                    mdm: null
                  contact:
                    name: Test name 1
                    email: testemail1@emailtest.com
                    telephone: '+11234567890'
                delivery:
                  address:
                    companyName: Test-Delivery1
                    addressId: TestDelivery1
                    addressLine1: Test address delivery 1
                    addressLine2: Test address delivery 1.2
                    addressLine3: null
                    city: TestCityDelivery1
                    countryCode: US
                    state: NY
                    zipCode: '00000'
                    instructions: null
                    mdm: null
                  contact:
                    name: TestName
                    email: testemail3@emailtest.com
                    telephone: '+112345678901'
                pickup:
                  address:
                    companyName: Test-Pickup1
                    addressId: TestPickup1
                    addressLine1: Test address pickup 1
                    addressLine2: Test address pickup 1.2
                    addressLine3: null
                    city: TestCityPickup1
                    countryCode: DK
                    state: null
                    zipCode: '0000'
                    instructions: null
                    mdm: null
                  contact:
                    name: TestName
                    email: testemail2@emailtest.com
                    telephone: '+451234567890'
                freightPayer:
                  address:
                    mdm: '**Add your Demo MDM**'
                bookingParty:
                  address:
                    mdm: '**Add your Demo MDM**'
              packages:
              - quantity: 1
                packageType: BAG
                totalWeight: 1500
                netWeight: 1000
                length: 60
                height: 80
                width: 70
                stackable: STACKABLE
                totalVolume: 0.336
                palletSpace: null
                loadingMeters: 2
                description: Test goods 1
                shippingMarks: Test shipping marks 1
              - quantity: 2
                packageType: BAG
                totalWeight: 1200
                netWeight: 800
                length: 30
                height: 50
                width: 40
                stackable: 'NO'
                totalVolume: 0.12
                palletSpace: null
                loadingMeters: 1
                description: Test goods 2
                shippingMarks: Test shipping marks 2
              references:
              - value: TestReference1
                type: INVOICING_REFERENCE
              - value: TestReference2
                type: ORDER_NUMBER
              - value: TestReference3
                type: CONSIGNEE_REFERENCE
              - value: TestReference4
                type: SHIPPER_REFERENCE
              - value: TestReference5
                type: OTHER
              units:
                dimension: CM
                weight: KG
                volume: M3
                loadingSpace: LM
                temperature: C
          application/Sea-json:
            schema:
              $ref: '#/components/schemas/Order'
            example:
              autobook: true
              labelRequest: false
              product:
                name: Sea
                billOfLading: Original
                containerMode: FCL
                containers:
                - ref: A484755
                  type: 45HC
                  genset: null
                  temp: null
                dropOff: false
              services:
                insurance:
                  amount:
                    value: 500
                    currency: DKK
                  category: STD
              incoterms:
                code: CFR
                location: TestLocation
              pickupTime:
                date: '2025-03-15'
              deliveryTime:
                date: '2025-03-19'
              pickupInstructions:
              - Test Pickup instruction
              deliveryInstructions:
              - Test Delivery instruction
              parties:
                sender:
                  address:
                    companyName: Test-Sender1
                    addressId: Test1
                    addressLine1: Test address 1
                    addressLine2: Test address 1.2
                    addressLine3: null
                    city: TestCity1
                    countryCode: DK
                    state: null
                    zipCode: '0000'
                    instructions: null
                    mdm: null
                  contact:
                    name: Test Name
                    email: testemail@testemail.com
                    telephone: '+4512345678'
                receiver:
                  address:
                    companyName: Test-Receiver1
                    addressId: Test2
                    addressLine1: Test address 1
                    addressLine2: Test address 1.2
                    addressLine3: null
                    city: TestCity2
                    countryCode: US
                    state: NY
                    zipCode: '000000'
                    instructions: null
                    mdm: null
                  contact:
                    name: Test name 1
                    email: testemail1@emailtest.com
                    telephone: '+11234567890'
                delivery:
                  address:
                    companyName: Test-Delivery1
                    addressId: TestDelivery1
                    addressLine1: Test address delivery 1
                    addressLine2: Test address delivery 1.2
                    addressLine3: null
                    city: TestCityDelivery1
                    countryCode: US
                    state: NY
                    zipCode: '00000'
                    instructions: null
                    mdm: null
                  contact:
                    name: TestName
                    email: testemail3@emailtest.com
                    telephone: '+112345678901'
                pickup:
                  address:
                    companyName: Test-Pickup1
                    addressId: TestPickup1
                    addressLine1: Test address pickup 1
                    addressLine2: Test address pickup 1.2
                    addressLine3: null
                    city: TestCityPickup1
                    countryCode: DK
                    state: null
                    zipCode: '0000'
                    instructions: null
                    mdm: null
                  contact:
                    name: TestName
                    email: testemail2@emailtest.com
                    telephone: '+451234567890'
                freightPayer:
                  address:
                    mdm: '**Add your Demo MDM**'
                bookingParty:
                  address:
                    mdm: '**Add your Demo MDM**'
              packages:
              - quantity: 5
                packageType: CON
                totalWeight: 5000
                netWeight: null
                length: 1500
                height: 100
                width: 10
                stackable: 'NO'
                totalVolume: 7.5
                palletSpace: null
                loadingMeters: 2
                description: Test goods 1
                shippingMarks: Test shipping marks 1
              references:
              - value: TestReference1
                type: INVOICING_REFERENCE
              - value: TestReference2
                type: ORDER_NUMBER
              - value: TestReference3
                type: CONSIGNEE_REFERENCE
              - value: TestReference4
                type: SHIPPER_REFERENCE
              - value: TestReference5
                type: OTHER
              units:
                dimension: CM
                weight: KG
                volume: M3
                loadingSpace: LM
                temperature: C
          application/Rail-json:
            schema:
              $ref: '#/components/schemas/Order'
            example:
              autobook: true
              labelRequest: false
              product:
                name: Rail
                containerMode: LCL
                dropOff: false
              services:
                insurance:
                  amount:
                    value: 100
                    currency: DKK
                  category: STD
              incoterms:
                code: EXW
                location: TestCityPickup1
              pickupTime:
                date: '2025-03-15'
              deliveryTime:
                date: '2025-03-19'
              pickupInstructions:
              - Test Pickup instruction
              deliveryInstructions:
              - Test Delivery instruction
              parties:
                sender:
                  address:
                    companyName: Test-Sender1
                    addressId: Test1
                    addressLine1: Test address 1
                    addressLine2: Test address 1.2
                    addressLine3: null
                    city: TestCity1
                    countryCode: DK
                    state: null
                    zipCode: '0000'
                    instructions: null
                    mdm: null
                  contact:
                    name: Test Name
                    email: testemail@testemail.com
                    telephone: '+4512345678'
                receiver:
                  address:
                    companyName: Test-Receiver1
                    addressId: Test2
                    addressLine1: Test address 1
                    addressLine2: Test address 1.2
                    addressLine3: null
                    city: TestCity2
                    countryCode: US
                    state: NY
                    zipCode: '000000'
                    instructions: null
                    mdm: null
                  contact:
                    name: Test name 1
                    email: testemail1@emailtest.com
                    telephone: '+11234567890'
                delivery:
                  address:
                    companyName: Test-Delivery1
                    addressId: TestDelivery1
                    addressLine1: Test address delivery 1
                    addressLine2: Test address delivery 1.2
                    addressLine3: null
                    city: TestCityDelivery1
                    countryCode: US
                    state: NY
                    zipCode: '00000'
                    instructions: null
                    mdm: null
                  contact:
                    name: TestName
                    email: testemail3@emailtest.com
                    telephone: '+112345678901'
                pickup:
                  address:
                    companyName: Test-Pickup1
                    addressId: TestPickup1
                    addressLine1: Test address pickup 1
                    addressLine2: Test address pickup 1.2
                    addressLine3: null
                    city: TestCityPickup1
                    countryCode: DK
                    state: null
                    zipCode: '0000'
                    instructions: null
                    mdm: null
                  contact:
                    name: TestName
                    email: testemail2@emailtest.com
                    telephone: '+451234567890'
                freightPayer:
                  address:
                    mdm: '**Add your Demo MDM**'
                bookingParty:
                  address:
                    mdm: '**Add your Demo MDM**'
              packages:
              - quantity: 1
                packageType: BAG
                totalWeight: 1500
                netWeight: 1000
                length: 60
                height: 80
                width: 70
                stackable: STACKABLE
                totalVolume: 0.336
                palletSpace: null
                loadingMeters: 2
                description: Test goods 1
                shippingMarks: Test shipping marks 1
              - quantity: 2
                packageType: BAG
                totalWeight: 1200
                netWeight: 800
                length: 30
                height: 50
                width: 40
                stackable: 'NO'
                totalVolume: 0.12
                palletSpace: null
                loadingMeters: 1
                description: Test goods 2
                shippingMarks: Test shipping marks 2
              references:
              - value: TestReference1
                type: INVOICING_REFERENCE
              - value: TestReference2
                type: ORDER_NUMBER
              - value: TestReference3
                type: CONSIGNEE_REFERENCE
              - value: TestReference4
                type: SHIPPER_REFERENCE
              - value: TestReference5
                type: OTHER
              units:
                dimension: CM
                weight: KG
                volume: M3
                loadingSpace: LM
                temperature: C
      responses:
        '200':
          description: Booking submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlaceBookingResponse'
              example:
                bookingId: '40257145990010780000'
        '400':
          description: Request contains not valid data
          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
        '401':
          description: Not authorized
          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
        '403':
          description: Lack of privileges to use this method
          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
        '500':
          description: Internal Server Error
          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
    servers:
    - url: https://api.dsv.com/my-demo/booking/v2
  /bookings/validate:
    post:
      tags:
      - Booking
      summary: 2. Validate booking
      description: Validate the content of a booking prior to submitting the final booking to DSV. Bookings sent via this method are not processed by DSV.
      operationId: validateOrder
      parameters:
      - name: Authorization
        in: header
        description: OAuth header
        required: true
        schema:
          type: string
      - name: DSV-Subscription-Key
        in: header
        description: DSV Subscription Key
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Order'
            example:
              autobook: false
              templateName: Template Test
              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: Test State
                    zipCode: '1234'
                    instructions: Specific Address Party Instrution
                    mdm: '6412345678'
                    eori: DE123456789012AZ
                    approvedShipper: string
                  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: null
                    zipCode: '1234'
                    instructions: Specific Address Party Instrution
                    mdm: '6412345678'
                    eori: DE123456789012AZ
                    approvedShipper: string
                  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: null
                    zipCode: '1234'
                    instructions: Specific Address Party Instrution
                    mdm: '6412345678'
                    eori: DE123456789012AZ
                    approvedShipper: string
                  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: null
                    zipCode: '1234'
                    instructions: Specific Address Party Instrution
                    mdm: '6412345678'
                    eori: DE123456789012AZ
                    approvedShipper: string
                  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: null
                    zipCode: '1234'
                    instructions: Specific Address Party Instrution
                    mdm: '6412345678'
                    eori: DE123456789012AZ
                    approvedShipper: string
                  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: null
                    zipCode: '1234'
                    instructions: Specific Address Party Instrution
                    mdm: '6412345678'
                    eori: DE123456789012AZ
                    approvedShipper: string
                  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: null
                    zipCode: '1234'
                    instructions: Specific Address Party Instrution
                    mdm: '6412345678'
                    eori: DE123456789012AZ
                    approvedShipper: string
                  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: null
                    zipCode: '1234'
                    instructions: Specific Address Party Instrution
                    mdm: '6412345678'
                    eori: DE123456789012AZ
                    approvedShipper: string
                  contact:
                    name: Test Name
                    email: testemail@testcompany.com
                    telephone: '+4512345678'
              product:
                name: Sea
                billOfLading: Original
                containerMode: FCL
                containers:
                - ref: TestContainerNumber1
                  type: 20RE
                  genset: true
                  temp: -20
                dropOff: false
              services:
                serviceLevel: '401'
                cashOnDelivery:
                  amount:
                    value:

# --- truncated at 32 KB (273 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dsv/refs/heads/main/openapi/dsv-booking-api-openapi.yml