Kuehne+Nagel Shipment API

openapi: 3.2.0
info:
  title: ShipmentTracking Shipment API
  description: 'Receive detailed information for one shipment per unique key (ID or tracking number),

    find one or more shipments per other not-necessarily unique key reference (esp. customer

    reference) or filter all shipments by reference, mode of transport, stage or time frame.

    '
  contact:
    name: API Support
    url: https://home.kuehne-nagel.com/en/service-request-api?lead_topic=api-portal-integration
  version: v2
  x-api-version: 2.5.0
  x-api-id: 4c199d23-391d-41d2-90fe-7224d75575cc
  x-api-guideline-version: 1.11.6
servers:
- url: https://internal.api.kuehne-nagel.com/track-trace/shipment/v2
security:
- default: []
- api_key: []
tags:
- name: shipment
paths:
  /shipments:
    get:
      tags:
      - shipment
      description: Retrieve a list of shipments for the given customer reference (exact match required).
      operationId: loadShipmentsForCustomerReference
      parameters:
      - $ref: '#/components/parameters/customerReferenceParameter'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShipmentSearchResponse'
        default:
          $ref: '#/components/responses/default'
      security:
      - default: []
      - api_key: []
      x-auth-type: Application & Application User
      x-throttling-tier: 50KPerMin
  /shipments-search:
    post:
      tags:
      - shipment
      description: Search for shipments with optional filters. Supports pagination via the request body. Returns shipments ordered by creation date descending.
      operationId: searchShipments
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ShipmentSearchRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShipmentSearchResponse'
        '400':
          description: Bad request. Possible reasons - unknown date filter type, or invalid date format (expected YYYY-MM-DD).
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '422':
          description: Unprocessable entity. The request is well-formed but violates business rules. Possible reasons - date filter present but neither 'from' nor 'to' specified.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        default:
          $ref: '#/components/responses/default'
      security:
      - default: []
      - api_key: []
      x-auth-type: Application & Application User
      x-throttling-tier: 50KPerMin
  /shipments/{shipmentId}/history-records:
    get:
      tags:
      - shipment
      description: Retrieve the milestone change history for a shipment, ordered by update time descending.
      operationId: loadShipmentHistory
      parameters:
      - name: shipmentId
        in: path
        required: true
        style: simple
        explode: false
        schema:
          $ref: '#/components/schemas/ShipmentId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShipmentHistory'
        default:
          $ref: '#/components/responses/default'
      security:
      - default: []
      - api_key: []
      x-auth-type: Application & Application User
      x-throttling-tier: 50KPerMin
  /shipments/{uniqueShipmentReference}:
    get:
      tags:
      - shipment
      description: Retrieve a specific shipment with an unique reference like shipmentId or trackingNumber.
      operationId: loadShipmentForUniqueReference
      parameters:
      - $ref: '#/components/parameters/uniqueShipmentReferenceParameter'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrackingResponse'
        default:
          $ref: '#/components/responses/default'
      security:
      - default: []
      - api_key: []
      x-auth-type: Application & Application User
      x-throttling-tier: 50KPerMin
components:
  schemas:
    ShipmentId:
      type: integer
      description: The unique id of the shipment
      format: int64
      example: 19101910
    CargoInfo:
      type: object
      properties:
        chargeableWeight:
          $ref: '#/components/schemas/Weight'
        numberOfPackages:
          $ref: '#/components/schemas/NumberOfPackages'
        shipmentDescriptionOfGoods:
          type: array
          description: Description of goods at shipment level (from cargo totals only)
          items:
            type: string
        marksAndNumbers:
          maxItems: 10000
          type: array
          description: 'Container specific marks and numbers Deprecated: use cargoItems[].marksAndNumbers instead

            '
          example:
          - mark
          - number
          deprecated: true
          items:
            type: string
        cargoItems:
          maxItems: 10000
          type: array
          description: Individual cargo items with dimensions and descriptions
          items:
            $ref: '#/components/schemas/CargoItem'
    Width:
      type: object
      properties:
        value:
          type: number
          description: Width value.
          format: double
          example: 0.2
        unit:
          type: string
          description: Width unit.
          example: M
    LocationMilestoneType:
      type: string
      description: The type of activity at the location
      example: CARGO_PICKED_UP
      x-extensible-enum:
      - CONTAINER_GATE_OUT_EMPTY
      - CONTAINER_LOADED
      - CONTAINER_UNLOADED
      - CARGO_PICKED_UP
      - CARGO_AVAILABLE
      - VEHICLE_ARRIVED
      - VEHICLE_DISCHARGED
      - VEHICLE_LOADED
      - VEHICLE_DEPARTED
      - CARGO_DELIVERED
      - CARGO_AT_CARRIER
      - CARGO_CHECKED_IN
      - CONTAINER_GATE_IN_EMPTY
      - READY_FOR_PICKUP
      - GATE_IN
      - GATE_OUT
      - FREIGHT_COLLECTION
      - IN_DELIVERY
    ExplainedDateTime:
      type: object
      properties:
        flexDateTime:
          $ref: '#/components/schemas/DateTime'
        dateTime:
          $ref: '#/components/schemas/IsoDateTime'
        condition:
          type: string
          x-extensible-enum:
          - PLANNED
          - ACTUAL
        explanation:
          $ref: '#/components/schemas/Explanation'
    TrackingResponse:
      type: object
      properties:
        shipmentId:
          $ref: '#/components/schemas/ShipmentId'
        trackingNumber:
          $ref: '#/components/schemas/TrackingNumber'
        bookingId:
          type: string
          description: The booking id of the shipment
          example: PUSM91305500
        modeOfTransport:
          $ref: '#/components/schemas/ModeOfTransport'
        serviceType:
          type: string
          description: The service type of this shipment
          example: FCL
        shipmentReferences:
          $ref: '#/components/schemas/ShipmentReferences'
        shippingInfo:
          $ref: '#/components/schemas/ShippingInfo'
        parties:
          $ref: '#/components/schemas/Parties'
        freightInfo:
          $ref: '#/components/schemas/FreightInfo'
        routing:
          $ref: '#/components/schemas/Routing'
        emissionInfo:
          $ref: '#/components/schemas/EmissionInfo'
        masterTrackingNumbers:
          type: array
          description: The tracking numbers of the master shipment (only for LCLs linked to a buyer's consol master)
          example:
          - TEST1910
          items:
            type: string
        shipmentCreationDateTime:
          $ref: '#/components/schemas/DateTime'
        shipmentCreationIsoDateTime:
          $ref: '#/components/schemas/IsoDateTime'
        links:
          type: object
          properties:
            containers:
              maxItems: 1000
              type: array
              description: Links to the container detail pages
              items:
                type: string
            serviceProviders:
              maxItems: 10
              type: array
              description: Links to service provider tracking pages
              items:
                type: string
          description: Links to related resources
    Weight:
      type: object
      properties:
        value:
          type: number
          description: Weight value.
          format: double
          example: 12.48
        unit:
          type: string
          description: Weight unit.
          example: KG
    RouteLocationType:
      type: string
      description: The type of route location
      example: ORIGIN
      x-extensible-enum:
      - ORIGIN_DEPOT
      - ORIGIN
      - ORIGIN_CFS
      - ORIGIN_RAIL_RAMP
      - ORIGIN_RAIL_TERMINAL_ARRIVAL
      - ORIGIN_TERMINAL
      - ORIGIN_STATION
      - DEPARTURE
      - TRANSIT
      - CROSSDOCK_STATION
      - GATEWAY_STATION
      - ARRIVAL
      - DESTINATION_TERMINAL
      - DESTINATION_CFS
      - DESTINATION_RAIL_TERMINAL_DEPARTURE
      - DESTINATION_RAIL_RAMP
      - DESTINATION
      - DESTINATION_DEPOT
      - DESTINATION_STATION
    ModeOfTransport:
      type: string
      description: The mode of transport of this shipment
      example: SEA
      x-extensible-enum:
      - AIR
      - SEA
      - ROAD
    Vehicle:
      type: object
      properties:
        voyageNumber:
          type: string
          description: The voyage number of the vehicle
          example: UA305A
        truckNumber:
          type: string
          description: The truck number of the vehicle
          example: MOU370486781
        vesselName:
          type: string
          description: The vessel name of the vehicle
          example: MS Ship
        lloydsRegisterCode:
          type: string
          description: The lloyds register code of the vehicle
          example: '9247742'
        carrierCode:
          type: string
          description: The carrier code of the vehicle
          example: CMDU
        flightNumber:
          type: string
          description: The flight number of the vehicle
          example: LH 765
        aircraftType:
          type: string
          description: The aircraft type of the vehicle
          example: '332'
      description: Information about the vehicle (vessel, flight or truck)
    LocationMilestone:
      type: object
      properties:
        description:
          type: string
          description: Description of the location milestone (not populated currently)
          example: The vehicle has arrived
        reached:
          type: boolean
          description: Flag if the location milestone was already reached
          example: true
        locationMilestoneType:
          $ref: '#/components/schemas/LocationMilestoneType'
        achievementDateTime:
          $ref: '#/components/schemas/ExplainedDateTime'
      description: Provides details of where the shipment is on its journey
    TransportInformationMilestone:
      type: object
      properties:
        type:
          type: string
          description: The type of the milestone (constant)
          example: TRANSPORT_INFORMATION_MILESTONE
          enum:
          - TRANSPORT_INFORMATION_MILESTONE
        key:
          type: object
          properties:
            transportInformationMilestoneType:
              type: string
              example: BOOKING_CONFIRMATION
              x-extensible-enum:
              - BOOKING_SUBMISSION
              - BOOKING_MODIFICATION
              - BOOKING_ACKNOWLEDGEMENT
              - BOOKING_CONFIRMATION
              - CANCELLATION
              - EXPORT_CUSTOMS_CLEARANCE_START
              - EXPORT_CUSTOMS_CLEARANCE_COMPLETE
              - IMPORT_CUSTOMS_CLEARANCE_START
              - IMPORT_CUSTOMS_ENTRY_TRANSMISSION
              - IMPORT_CUSTOMS_CLEARANCE_COMPLETE
              - IMPORT_CUSTOMS_DELIVERY_AGENT_NOTIFICATION
              - IMPORT_CUSTOMS_BILLING_INVOICE_AVAILABLE
              - IMPORT_CUSTOMS_DUTIES_PAYMENT
              - CUSTOMS_CLEARANCE_START
              - CUSTOMS_CLEARANCE_COMPLETE
              - CUSTOMS_ENTRY_TRANSMISSION
              - CUSTOMS_DELIVERY_AGENT_NOTIFICATION
              - CUSTOMS_BILLING_INVOICE_AVAILABLE
              - CUSTOMS_DUTIES_PAYMENT
              - CARGO_COMMODITY_UPDATE
              - MAWB_AVAILABLE
              - HAWB_AVAILABLE
              - CARRIER_BOOKING_SUBMISSION
              - CARRIER_BOOKING_CONFIRMATION
              - CARRIER_BOOKING_REJECTION
              - BAL_BL_AVAILABLE
              - POD_AVAILABLE
              - SERVICE_COMPLETE
              - SHIPPING_INSTRUCTIONS_RECEIPT
              - ORIGINAL_TRANSPORT_DOCUMENT_RECEIPT
              - ADVICE_TO_BROKER_OR_CUSTOMER
              - VGM_DATA_VERIFICATION
              - VGM_MESSAGE_TO_PROVIDER
              - VGM_CLOSURE
              - IMPORTER_SECURITY_FILING_BILL_OF_LADING_MATCH
              - IMPORTER_SECURITY_FILING_CONFIRMATION
              - EXPORT_SECURITY_FILING_CONFIRMATION
              - CUSTOMS_MANIFEST_FILING_SUBMISSION
              - CUSTOMS_MANIFEST_FILING_CONFIRMATION
              - STORAGE_EXPORT
              - STORAGE_IMPORT
              - FREIGHT_DOCUMENTS_HANDOVER
              - WAITING_FOR_SHIPPING_APPROVAL
              - SHIPMENT_RELEASE_BY_CUSTOMER
              - MISSING_OR_INCOMPLETE_DOCUMENT
              - DOCUMENT_UPLOAD_BY_CUSTOMER
              - EXPEDITED_RAIL_SERVICE
              - DELIVERY_APPOINTMENT_SUBMISSION
              - LEGISLATION_COMPLIANCE_OK
              - LIEGISLATION_COMPLIANCE_REJECTED
        children:
          type: array
          description: Customs information milestones may have additional sub-milestones.
          items:
            $ref: '#/components/schemas/TransportInformationMilestoneChild'
        plannedAchievementDateTime:
          $ref: '#/components/schemas/ExplainedDateTime'
        actualAchievementDateTime:
          $ref: '#/components/schemas/ExplainedDateTime'
    ShipmentSearchFilters:
      type: object
      properties:
        reference:
          maxLength: 255
          type: string
          description: Customer reference to filter shipments by. The reference must match completely.
          example: MY-REF-123
        modesOfTransport:
          type: array
          description: Filter shipments by one or more modes of transport.
          example:
          - AIR
          items:
            $ref: '#/components/schemas/ModeOfTransport'
        stages:
          type: array
          description: Filter shipments by one or more current stages.
          example:
          - BOOKED
          items:
            $ref: '#/components/schemas/CurrentStage'
        date:
          $ref: '#/components/schemas/ShipmentDateFilter'
      description: Optional filters for shipment search. All filter attributes are optional.
    ShipmentSearchRequest:
      type: object
      properties:
        pagination:
          $ref: '#/components/schemas/PaginationRequest'
        filters:
          $ref: '#/components/schemas/ShipmentSearchFilters'
    ShippingInfo:
      type: object
      properties:
        incoterm:
          $ref: '#/components/schemas/Incoterm'
        orderedKnServices:
          type: array
          description: The ordered Kuehne+Nagel services
          example:
          - sea
          - ech
          items:
            type: string
        balInfo:
          $ref: '#/components/schemas/BlueAnchorLineInformation'
        businessSolution:
          $ref: '#/components/schemas/BusinessSolution'
        movementType:
          type: string
          description: The human-readable movement type (e.g. CY/CY)
          example: CY/CY
        carriers:
          maxItems: 10
          type: array
          description: The carriers involved in the shipment
          items:
            type: object
            properties:
              code:
                type: string
                description: The carrier code
                example: MAEU
              name:
                type: string
                description: The carrier name
                example: Maersk
    RouteLocation:
      type: object
      properties:
        reached:
          type: boolean
          description: Flag if the location has been reached (i.e. the first location milestone has been reached)
          example: true
        completed:
          type: boolean
          description: Flag if the location has been completed (i.e. all location milestones have been reached)
          example: false
        type:
          $ref: '#/components/schemas/RouteLocationType'
        location:
          $ref: '#/components/schemas/Location'
        locationMilestones:
          type: array
          description: The location milestones that belong to this location
          items:
            $ref: '#/components/schemas/LocationMilestone'
        outgoingVehicle:
          $ref: '#/components/schemas/Vehicle'
      description: The description of a location on the route
    NumberOfPackages:
      type: integer
      description: The total number of packages
      format: int32
      example: 4
    ContainerInfo:
      type: object
      properties:
        containers:
          type: array
          description: The containers of the shipment
          items:
            $ref: '#/components/schemas/Container'
        numberOfContainers:
          type: integer
          description: The total number of containers per shipment
          format: int32
          example: 3
    TransportInformationMilestoneChild:
      type: object
      properties:
        key:
          type: string
          example: FDA_HOLD
          x-extensible-enum:
          - CUSTOMS_DOCUMENTATION_FIRST_RECEIVED
          - UNABLE_TO_FILE_CUSTOMS_ENTRY_MISSING_DETAILS_OR_DOCUMENTATION
          - CUSTOMS_ENTRY_DETAILS_AND_DOCUMENTATION_COMPLETE
          - CUSTOMS_ARRIVAL_INFORMATION_CONFIRMED
          - ENTRY_PENDING_INTENSIVE_EXAM
          - ENTRY_DOCUMENTS_REQUIRED
          - MANIFEST_HOLD_CUSTOMS
          - MANIFEST_HOLD_AGRICULTURE
          - AGRICULTURE_MANIFEST_HOLD_REMOVED
          - CUSTOMS_MANIFEST_HOLD_REMOVED
          - CUSTOMS_CARGO_RELEASE_CERTIFIED
          - FDA_HOLD
          - FDA_EXAM_SAMPLE
          - FDA_REVIEW
          - FDA_REJECTED
          - FDA_DO_NOT_DEVAN
          - FDA_MOVE_TO_SECURE_HOLDING_FACILITY
          - FDA_DOCUMENTS_REQUIRED
          - ENTRY_SUMMARY_ACCEPTED
          - PGA_REVIEW
          - PGA_HOLD_INTACT
          - PGA_REJECTED
          - PGA_DO_NOT_DEVAN
          - PGA_MOVE_TO_SECURE_HOLDING_FACILITY
          - PGA_DOCUMENTS_REQUIRED
          - PGA_EXAM_SAMPLE
          - CUSTOMS_ENTRY_DOCUMENTATION_ARCHIVED
          - CUSTOMS_RELEASE_FROM_EXAM
          - FDA_MAY_PROCEED
          - ONE_USG_FULL_GOVERNMENT_AGENCY_RELEASE
          - PGA_MAY_PROCEED
          - CUSTOMS_BILLING_INVOICE_SENT
          - AWAITING_T1_DISCHARGE
          - T1_DISCHARGE
          - OPEN_SUBSEQUENT_T1
          - AWAITING_CONSIGNEES_FEEDBACK
          - NO_FEEDBACK_FROM_CONSIGNEE
          - AWAITING_CONSIGNEES_PAYMENT
          - CLARIFICATION_BY_CUSTOMS_AUTHORITIES
          - WAITING_FOR_SHIPPING_APPROVAL
          - SHIPMENT_RELEASE_BY_CUSTOMER
          - MISSING_OR_INCOMPLETE_DOCUMENT
          - DOCUMENT_UPLOAD_BY_CUSTOMER
        achievementDateTime:
          $ref: '#/components/schemas/ExplainedDateTime'
    PageInfo:
      type: object
      properties:
        totalElements:
          type: integer
          description: Total number of elements across all pages
          format: int64
          example: 150
        totalPages:
          type: integer
          description: Total number of pages
          format: int32
          example: 8
        currentPage:
          type: integer
          description: Current page number (0-indexed)
          format: int32
          example: 0
        size:
          type: integer
          description: Requested page size
          format: int32
          example: 20
        actualSize:
          type: integer
          description: Actual number of elements in the current page
          format: int32
          example: 20
        hasNext:
          type: boolean
          description: Whether there is a next page
          example: true
        hasPrevious:
          type: boolean
          description: Whether there is a previous page
          example: false
      description: Pagination metadata for the response
    Explanation:
      type: object
      properties:
        source:
          type: string
          x-extensible-enum:
          - ETD
          - ETA
          - STATUS
          - TRODO
          - TROAP
          - TADDO
          - TADAP
        statusCode:
          type: string
          description: The KN status code
          example: '2400'
    HistoryMilestoneKey:
      type: object
      properties:
        routeLocationType:
          $ref: '#/components/schemas/RouteLocationType'
        locationMilestoneType:
          $ref: '#/components/schemas/LocationMilestoneType'
        transportInformationMilestoneType:
          type: string
          example: BOOKING_CONFIRMATION
          x-extensible-enum:
          - ADVICE_TO_BROKER_OR_CUSTOMER
          - BAL_BL_AVAILABLE
          - BOOKING_ACKNOWLEDGEMENT
          - BOOKING_CONFIRMATION
          - BOOKING_MODIFICATION
          - BOOKING_SUBMISSION
          - CANCELLATION
          - CARGO_COMMODITY_UPDATE
          - CARRIER_BOOKING_CONFIRMATION
          - CARRIER_BOOKING_REJECTION
          - CARRIER_BOOKING_SUBMISSION
          - CUSTOMS_BILLING_INVOICE_AVAILABLE
          - CUSTOMS_CLEARANCE_COMPLETE
          - CUSTOMS_CLEARANCE_START
          - CUSTOMS_DELIVERY_AGENT_NOTIFICATION
          - CUSTOMS_DUTIES_PAYMENT
          - CUSTOMS_ENTRY_TRANSMISSION
          - CUSTOMS_MANIFEST_FILING_CONFIRMATION
          - CUSTOMS_MANIFEST_FILING_SUBMISSION
          - DELIVERY_APPOINTMENT_SUBMISSION
          - DOCUMENT_UPLOAD_BY_CUSTOMER
          - EXPEDITED_RAIL_SERVICE
          - EXPORT_CUSTOMS_CLEARANCE_COMPLETE
          - EXPORT_CUSTOMS_CLEARANCE_START
          - EXPORT_SECURITY_FILING_CONFIRMATION
          - FREIGHT_DOCUMENTS_HANDOVER
          - HAWB_AVAILABLE
          - IMPORT_CUSTOMS_CLEARANCE_START
          - IMPORT_CUSTOMS_ENTRY_TRANSMISSION
          - IMPORT_CUSTOMS_CLEARANCE_COMPLETE
          - IMPORT_CUSTOMS_DELIVERY_AGENT_NOTIFICATION
          - IMPORT_CUSTOMS_BILLING_INVOICE_AVAILABLE
          - IMPORT_CUSTOMS_DUTIES_PAYMENT
          - IMPORTER_SECURITY_FILING_BILL_OF_LADING_MATCH
          - IMPORTER_SECURITY_FILING_CONFIRMATION
          - LEGISLATION_COMPLIANCE_OK
          - LEGISLATION_COMPLIANCE_REJECTED
          - MAWB_AVAILABLE
          - MISSING_OR_INCOMPLETE_DOCUMENT
          - ORIGINAL_TRANSPORT_DOCUMENT_RECEIPT
          - POD_AVAILABLE
          - SERVICE_COMPLETE
          - SHIPMENT_RELEASE_BY_CUSTOMER
          - SHIPPING_INSTRUCTIONS_RECEIPT
          - STORAGE_EXPORT
          - STORAGE_IMPORT
          - VGM_CLOSURE
          - VGM_DATA_VERIFICATION
          - VGM_MESSAGE_TO_PROVIDER
          - WAITING_FOR_SHIPPING_APPROVAL
      description: 'Identifies the milestone that was updated.

        For ROUTE_LOCATION_MILESTONE: routeLocationType and locationMilestoneType are populated.

        For INFORMATION_MILESTONE: transportInformationMilestoneType is populated.

        '
    Problem:
      required:
      - detail
      - title
      type: object
      properties:
        type:
          type: string
          description: 'A URI reference that uniquely identifies the problem type only in the context of the provided API. Opposed to the specification in RFC-7807, it is neither recommended to be dereferenceable and point to a human-readable documentation nor globally unique for the problem type.

            '
          format: uri-reference
          example: /problem/connection-error
          default: about:blank
        title:
          type: string
          description: 'A short summary of the problem type. Written in English and readable for engineers, usually not suited for non technical stakeholders and not localized.

            '
          example: Service Unavailable
        status:
          maximum: 600
          minimum: 100
          type: integer
          description: 'The HTTP status code generated by the origin server for this occurrence of the problem.

            '
          format: int32
          example: 503
        detail:
          type: string
          description: 'A human readable explanation specific to this occurrence of the problem that is helpful to locate the problem and give advice on how to proceed. Written in English and readable for engineers, usually not suited for non technical stakeholders and not localized.

            '
          example: Connection to database timed out
        instance:
          type: string
          description: 'A URI reference that identifies the specific occurrence of the problem, e.g. by adding a fragment identifier or sub-path to the problem type. May be used to locate the root of this problem in the source code.

            '
          format: uri-reference
          example: /problem/connection-error#token-info-read-timed-out
    Reference:
      type: object
      properties:
        partyType:
          type: string
          description: The partyType that belongs to this reference
          example: CU
        referenceType:
          type: string
          description: The type of the reference
          example: Z01
        referenceName:
          type: string
          description: The human-readable name of the reference type
          example: Customer Reference
        referenceValues:
          type: array
          description: The values of the reference
          example:
          - value
          - value2
          - value3
          items:
            type: string
    IsoDateTime:
      pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}(:\d{2}(:\d{2}(\.\d+)?)?)?(Z|[+-]\d{2}:\d{2})?)?$
      type: string
      description: Date and time in ISO 8601 format
      example: '2023-04-25T01:00:02Z'
    ShipmentSearchResponse:
      type: object
      properties:
        shipments:
          type: array
          description: The shipments that are found with matching shipment reference
          items:
            $ref: '#/components/schemas/Shipment'
        page:
          $ref: '#/components/schemas/PageInfo'
    Measurement:
      type: object
      properties:
        value:
          type: number
          description: Measurement value.
          format: double
          example: 12.48
        unit:
          type: string
          description: Measurement unit.
          example: KG
    FreightInfo:
      type: object
      properties:
        containerInfo:
          $ref: '#/components/schemas/ContainerInfo'
        cargoInfo:
          $ref: '#/components/schemas/CargoInfo'
        volume:
          $ref: '#/components/schemas/Volume'
        weight:
          $ref: '#/components/schemas/Weight'
        hasDangerousGoods:
          type: boolean
          description: Flag if the freight contains dangerous goods
          example: false
        labelPrinted:
          type: boolean
          description: Flag which indicates whether the label is printed
          example: false
    Quantity:
      type: object
      properties:
        value:
          type: number
          description: Quantity value.
          format: double
          example: 2
        unit:
          type: string
          description: Quantity unit.
          example: PCS
    PartyReference:
      type: object
      properties:
        references:
          type: array
          description: The reference values provided by / linked to particular types of parties
          items:
            $ref: '#/components/schemas/Reference'
    RouteLocationMilestone:
      type: object
      properties:
        type:
          type: string
          description: The type of the milestone (constant)
          example: ROUTE_LOCATION_MILESTONE
          enum:
          - ROUTE_LOCATION_MILESTONE
        key:
          type: object
          properties:
            routeLocationType:
              $ref: '#/components/schemas/RouteLocationType'
            locationMilestoneType:
              $ref: '#/components/schemas/LocationMilestoneType'
        city:
          type: string
          description: The city of the RouteLocation this milestone belongs to.
          example: Rostock
        stateCode:
          type: string
          description: The state code of the RouteLocation this milestone belongs to.
          example: MV
        countryCode:
          type: string
          description: The country code of the RouteLocation this milestone belongs to.
          example: DE
        plannedAchievementDateTime:
          $ref: '#/components/schemas/ExplainedDateTime'
        actualAchievementDateTime:
          $ref: '#/components/schemas/ExplainedDateTime'
    CurrentStage:
      type: string
      description: 'The current stage of the shipment.

        Attention: PRE_CARRIAGE, MAIN_CARRIAGE and ON_CARRIAGE are obsolete and will be removed in the future.

        '
      example: BOOKED
      x-extensible-enum:
      - BOOKED
      - PRE_CARRIAGE
      - MAIN_CARRIAGE
      - ON_CARRIAGE
      - IN_TRANSIT
      - COMPLETED
      - CANCELLED
    Party:
      type: object
      properties:
        partyType:
          type: string
          description: The type of the party
          example: CU
        address:
          $ref: '#/components/schemas/Address'
      description: Party (address) information
    BusinessSolution:
      type: object
      properties:
        code:
          type: string
          example: CRT
        name:
          type: string
          example: Aerospace Critical
      description: Shows the booked products
    RoutingCore:
      type: object
      properties:
        departureDate:
          $ref: '#/components/schemas/ExplainedDateTime'
        arrivalDate:
          $ref: '#/components/schemas/ExplainedDateTime'
        receivingDate:
          $ref: '#/components/schemas/ExplainedDateTime'
        completionDate:
          $ref: '#/components/schemas/ExplainedDateTime'
        routeLocations:
          type: array
          description: The locations of the routing with subordinate route location milestones
          items:
            $ref: '#/components/schemas/RouteLocation'
        fromLocation:
          $ref: '#/components/schemas/Location'
        toLocation:
          $ref: '#/components/schemas/Location'
      description: 'The core routing information. Note that the 4 dates below are deprecated and subject to be removed. Please take that information from the respective milestones in the routeLocations or milestoneInfo section instead.

        '
    Address:
      type: object
      properties:
        name:
          type: array
          description: Names of the address
          example:
          - Company abc
          - Division A
          items:
            type: string
        street:
          type: array
          description: Street names of the address
          example:
          - Mainstreet 10
          - Building ABC
          items:
            type: string
        city:
          type: array
          description: City names of the address
          example:
          - New Town
          - District Old Town
          items:
            type: string
        zipCode:
          type: string
          description: Zip code of the address in country-specific formats
          example: '21640'
        state:
          $ref: '#/components/schemas/State'
        countryCode:
          type: string
          description: This is the country code. E.g. DE for Germany
          format: iso-3166-alpha-2
          example: DK
        countryName:
          type: string
          description: Country name of the address
          example: Denmark
        postOfficeBox:
          type: string
          description: Post office box of the address
          example: '342353'
        printAddress:
          type: array
          description: The address for printing and displ

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