DSV

DSV Shipment details API

The Shipment details API from DSV — 4 operation(s) for shipment details.

Documentation GitHub OpenAPI

Operations 4

GET /shipments/bookingId/{bookingId} Shipment details by DSV Booking ID #

GET /shipments/tmsId/{tmsId} Shipment details by DSV Shipment ID #

GET /shipments/reference/{*reference} Shipment details by Customer reference #

POST /shipments/deviceReadings Get device readings by search filter #

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-shipment-details-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 Shipment details API
  version: '1.0'
  description: 'Operations tagged Shipment details across 2 of this provider''s published API definitions: dsv-generic-tracking-demo-v2-openapi.json, dsv-generic-visibilitydemo-v1-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.dsv.com/my-demo/tracking/v2
- url: https://api.dsv.com/my-demo/visibility/v1
security:
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: Shipment details
paths:
  /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>

        <BR>

        Authorization: client_id: api.demo@demo.dsv.com, client_secret: Demo12345</I> <BR><BR>

        Sample 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
    servers:
    - url: https://api.dsv.com/my-demo/tracking/v2
  /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>

        <BR>

        DEMO ACCOUNT<BR>Authorization: client_id: api.demo@demo.dsv.com, client_secret: Demo12345</I> <BR><BR>

        Sample 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]
                      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
    servers:
    - url: https://api.dsv.com/my-demo/tracking/v2
  /shipments/reference/{*reference}:
    get:
      tags:
      - Shipment details
      summary: Shipment details by Customer reference
      description: Retrieve detailed shipment data for a specific shipment by searching a Customer reference.
      operationId: getShipmentByReference
      parameters:
      - name: '*reference'
        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
                     

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