DHL

DHL Validation API

The Validation API from DHL — 1 operation(s) for validation.

GitHub OpenAPI

Operations 1

POST /dpi/shipping/v1/validation Validate Order Items #

Documentation

📖
Documentation
https://developer.dhl.com/tracking
📖
Documentation
https://developer.dhl.com/api-reference/shipment-tracking-unified-push
📖
Documentation
https://developer.dhl.com/api-reference/additional-services-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/authentication-dhl-ecommerce-americas
📖
Documentation
https://developer.dhl.com/api-reference/authentication-api-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/authentication-api-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/datafactory-autocomplete-20-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/deutsche-post-hybrid-mail-shipments-e-post-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/deutsche-post-international-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/deutsche-post-internetmarke-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/deutsche-post-print-mailing-dispatch-preparation-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/deutsche-post-print-mailing-targeting-post-parcel-germany
📖
Documentation
https://developer.dhl.com/parcel-connect
📖
Documentation
https://developer.dhl.com/api-reference/econnect-beta-dhl-ecommerce-europe
📖
Documentation
https://developer.dhl.com/api-reference/dhl-parcel-de-pickup-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/dhl-parcel-de-postnumber-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/dhl-parcel-de-private-shipping-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/dhl-parcel-de-returns-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/parcel-de-shipping-post-parcel-germany-v2
📖
Documentation
https://developer.dhl.com/api-reference/dhl-parcel-de-shipment-tracking-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/dgf-document
📖
Documentation
https://developer.dhl.com/api-reference/duty-tax-dhl-ecommerce-americas
📖
Documentation
https://developer.dhl.com/api-reference/ecommerce-uk
📖
Documentation
https://developer.dhl.com/api-reference/parcel-eu
📖
Documentation
https://developer.dhl.com/api-reference/pickup-cancellation-dhl-ecommerce-india-blue-dart
📖
Documentation
https://developer.dhl.com/api-reference/price-quote-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/print-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/product-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/product-and-sub-product-pickup-detail-dhl-ecommerce-india-blue-dart
📖
Documentation
https://developer.dhl.com/api-reference/product-finder-dhl-ecommerce-americas
📖
Documentation
https://developer.dhl.com/api-reference/products-api-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/dgf-push-api
📖
Documentation
https://developer.dhl.com/api-reference/registration-pickup-dhl-ecommerce-india-blue-dart
📖
Documentation
https://developer.dhl.com/api-reference/return-label-dhl-ecommerce-americas
📖
Documentation
https://developer.dhl.com/api-reference/shipment-booking-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/dgf-shipment-booking
📖
Documentation
https://developer.dhl.com/api-reference/shipment-label-dhl-global-forwarding
📖
Documentation
https://developer.dhl.com/api-reference/dgf-shipment-status
📖
Documentation
https://developer.dhl.com/api-reference/shipment-tracking-dhl-ecommerce-india-blue-dart
📖
Documentation
https://developer.dhl.com/api-reference/shipment-tracking-v2-dhl-global-forwarding
📖
Documentation
https://developer.dhl.com/api-reference/time-table-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/tracking-dhl-ecommerce-americas

Specifications

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/dhl:dhl-validation-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

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

OpenAPI Specification

dhl-validation-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Dhl Validation API
  version: 5.7.10
  description: 'Operations tagged Validation across 2 of this provider''s published API definitions: dhl-deutsche-post-international-post-parcel-germany-openapi.yml, dhl-deutsche-post-international-post-parcel-germany-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api-sandbox.dhl.com/
tags:
- name: Validation
paths:
  /dpi/shipping/v1/validation:
    post:
      operationId: validateOrderItem
      summary: Validate Order Items
      description: Validate OrderItems, required by efiliale
      tags:
      - Validation
      parameters:
      - name: Authorization
        in: header
        description: Bearer Auth access_token together with the "Bearer" prefix is required. **Example** of the header value:"*Bearer 0UuA.....*"
        required: true
        schema:
          type: string
          default: Bearer [place  OAuth access_token here, without brackets]
      - name: ThirdPartyVendor-ID
        in: header
        description: The ID of the 3PV/Third Party Vendor who wants to validate this item.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Validation'
        '400':
          description: bad request, please check response message for details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CwsErrorDTO'
        '401':
          description: Unauthorized, lease check response message for details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CwsErrorDTO'
        '406':
          description: not acceptable, please check response message for details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CwsErrorDTO'
        '422':
          description: Data error, please check response message for details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CwsErrorDTO'
        '500':
          description: Internal error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CwsErrorDTO'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Validation'
        description: The items that shall be validated.
        required: true
    servers:
    - url: https://api-sandbox.dhl.com/
components:
  schemas:
    Validation:
      properties:
        customerEkp:
          description: Customer Ekp
          type: string
        items:
          description: list of order Items
          items:
            $ref: '#/components/schemas/ItemData'
          type: array
      required:
      - customerEkp
      - items
      type: object
      example:
        customerEkp: '9012345678'
        items:
        - product: GMP
          serviceLevel: PRIORITY
          custRef: 02 03 02 02 T005
          recipient: Herschel Krustofsky
          recipientPhone: ''
          recipientFax: ''
          recipientEmail: ''
          addressLine1: Avenue des Champs-Élysées
          addressLine2: ''
          addressLine3: '103'
          city: Paris
          state: Île-de-France
          postalCode: '75020'
          destinationCountry: FR
          returnItemWanted: false
          shipmentAmount: 0
          shipmentCurrency: EUR
          shipmentGrossWeight: 500
    ItemData:
      properties:
        addressLine1:
          description: 'First line of address information of the recipient.

            No unicode replacement characters � or question mark is accepted.'
          example: Any Street 100
          maxLength: 40
          minLength: 1
          pattern: ^(?![=\-\+@])[^?�]*$
          type: string
        addressLine2:
          description: 'Second line of address information of the recipient.

            No unicode replacement characters � or question mark is accepted.'
          example: Flat 2
          maxLength: 40
          minLength: 0
          pattern: ^(?![=\-\+@])[^?�]*$
          type: string
        addressLine3:
          description: 'Third line of address information of the recipient.

            No unicode replacement characters � or question mark is accepted.'
          example: 1st floor
          maxLength: 40
          minLength: 0
          pattern: ^(?![=\-\+@])[^?�]*$
          type: string
        city:
          description: 'City of the recipient address.

            No unicode replacement characters � or question mark is accepted.'
          example: Any City
          maxLength: 30
          minLength: 1
          pattern: ^(?![=\-\+@])[^?�]*$
          type: string
        contents:
          description: The descriptions of the content pieces.
          items:
            $ref: '#/components/schemas/Content'
          type: array
        custRef:
          description: Reference text up to customer's choice
          example: REF-2361890-AB
          maxLength: 28
          minLength: 0
          type: string
        custRef2:
          description: NOT RECOMMENDED, obsolete and should not be contained in requests until further notice.
          maxLength: 28
          minLength: 0
          type: string
        custRef3:
          description: NOT RECOMMENDED, obsolete and should not be contained in requests until further notice.
          maxLength: 28
          minLength: 0
          type: string
        destinationCountry:
          description: Destination country of the item, based on ISO-3166-1. Please check https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for further details.
          pattern: '[A-Z]{2}'
          maxLength: 2
          minLength: 2
          example: DE
          type: string
        postalCode:
          description: 'Postal code of the recipient address. Consists of numbers, upper case letters, and one space or dash between characters

            No unicode replacement characters � or question mark is accepted.'
          example: 794
          maxLength: 10
          minLength: 3
          pattern: ^(?![=\-\+@])[^?�]*$
          type: string
        product:
          description: 'The product that is used for the shipment of this item. Available products are: GMP [Packet Priority/Prio (goods)], GPT [Packet Tracked/Tracked], GMM [Business Mail Priority/Prio (documents)], GMR [Business Mail Registered/Plus (documents)]'
          example: GMP
          type: string
        importerTaxId:
          description: Customs reference number of the recipient, if required and applicable e.g. EORI number.
          maxLength: 35
          minLength: 0
          example: 'EORI: LU12345'
          type: string
        recipient:
          description: 'Name of the recipient.

            No unicode replacement characters � and max. one question mark is accepted.'
          example: John Doe
          maxLength: 35
          minLength: 1
          pattern: ^(?![=\-\+@])[^?�]*\??[^?�]*$
          type: string
        recipientEmail:
          description: 'Email address of the recipient. Used for notification.

            recipientEmail OR recipientPhone required for interconnect countries!


            An e-mail address or phone number for the recipient must be provided. Many postal operators have implemented electronic pick-up notifications by e-mail or SMS and the provision of this information is essential to ensure the smooth delivery of your shipments.'
          example: john.doe@example.eu
          maxLength: 50
          minLength: 0
          type: string
        recipientFax:
          description: Fax number of the recipient
          example: '+441234567891'
          maxLength: 25
          minLength: 0
          type: string
        recipientPhone:
          description: 'Phone number of the recipient

            recipientEmail OR recipientPhone required for interconnect countries!


            An e-mail address or phone number for the recipient must be provided. Many postal operators have implemented electronic pick-up notifications by e-mail or SMS and the provision of this information is essential to ensure the smooth delivery of your shipments.'
          example: '+441234567891'
          maxLength: 25
          minLength: 0
          type: string
        returnItemWanted:
          default: false
          description: States if a return label should be created additionally. Requires a contract for Packet Return.
          example: false
          type: boolean
        senderAddressLine1:
          description: NOT RECOMMENDED, obsolete and should not be contained in requests until further notice.
          maxLength: 40
          minLength: 0
          type: string
        senderAddressLine2:
          description: NOT RECOMMENDED, obsolete and should not be contained in requests until further notice.
          maxLength: 40
          minLength: 0
          type: string
        senderCity:
          description: NOT RECOMMENDED, obsolete and should not be contained in requests until further notice.
          maxLength: 40
          minLength: 0
          type: string
        senderCountry:
          description: NOT RECOMMENDED, obsolete and should not be contained in requests until further notice.
          maxLength: 2
          minLength: 2
          type: string
        senderEmail:
          description: NOT RECOMMENDED, obsolete and should not be contained in requests until further notice.
          maxLength: 50
          minLength: 0
          type: string
        senderName:
          description: NOT RECOMMENDED, obsolete and should not be contained in requests until further notice.
          maxLength: 40
          minLength: 0
          type: string
        senderPhone:
          description: NOT RECOMMENDED, obsolete and should not be contained in requests until further notice.
          maxLength: 25
          minLength: 0
          type: string
        senderPostalCode:
          description: NOT RECOMMENDED, obsolete and should not be contained in requests until further notice.
          maxLength: 20
          minLength: 0
          type: string
        senderTaxId:
          description: Customs reference number of the sender, if applicable e.g. IOSS or VOEC number.
          maxLength: 35
          minLength: 0
          example: 'IOSS: ABC12345'
          type: string
        serviceLevel:
          description: 'The service level that is used for the shipment of this item. There are restrictions for use of service level: Registered is only available with product GMR and SalesChannel DPI'
          enum:
          - PRIORITY
          - REGISTERED
          example: PRIORITY
          type: string
        shipmentAmount:
          description: Overall value of all content pieces of the item.
          example: '100.00'
          format: double
          type: number
        shipmentCurrency:
          pattern: '[A-Z]{3}'
          description: Currency code of the value, based on ISO-4217. Please check https://en.wikipedia.org/wiki/ISO_4217#Active_codes for further details.
          maxLength: 3
          minLength: 3
          example: EUR
          type: string
        shipmentGrossWeight:
          description: Gross weight of the item (in g). May not exceed 2000 g.
          example: 1500
          format: int32
          maximum: 2000
          minimum: 1
          type: integer
        shipmentNaturetype:
          description: 'Nature of the pieces in this item. Mandatory for non-EU shipments: SALE_GOODS, RETURN_GOODS, COMMERCIAL_SAMPLE, DOCUMENTS, MIXED_CONTENTS, OTHERS. Mandatory for non-EU shipments.'
          enum:
          - SALE_GOODS
          - RETURN_GOODS
          - COMMERCIAL_SAMPLE
          - DOCUMENTS
          - MIXED_CONTENTS
          - OTHERS
          example: SALE_GOODS
          type: string
        state:
          description: 'State of the recipient address.

            No unicode replacement characters � or question mark is accepted.

            An empty string is still allowed'
          example: NC
          maxLength: 20
          minLength: 2
          pattern: ^(?![=\-\+@])(?:$|[^?�]{2,20}$)
          type: string
      required:
      - addressLine1
      - city
      - destinationCountry
      - product
      - serviceLevel
      - recipient
      - shipmentGrossWeight
      type: object
      example:
        id: 1
        product: GMP
        serviceLevel: PRIORITY
        custRef: REF-2361890-AB
        recipient: John Doe
        recipientPhone: '+4935120681234'
        recipientFax: '+4935120681234'
        recipientEmail: john.doe@example.eu
        addressLine1: Mustergasse 12
        addressLine2: Hinterhaus
        addressLine3: 1. Etage
        city: Dresden
        state: Sachsen
        postalCode: '01432'
        destinationCountry: DE
        shipmentAmount: 100
        shipmentCurrency: EUR
        shipmentGrossWeight: 1500
        returnItemWanted: false
        shipmentNaturetype: SALE_GOODS
        contents:
        - contentPieceHsCode: 1234567890
          contentPieceDescription: Trousers
          contentPieceValue: '120.50'
          contentPieceNetweight: 1200
          contentPieceOrigin: DE
          contentPieceAmount: 2
    Content:
      properties:
        contentPieceAmount:
          description: Number of pieces.
          example: 2
          format: int64
          maximum: 999
          minimum: 1
          type: integer
        contentPieceDescription:
          description: The (short) description of this content.
          example: Trousers
          maxLength: 33
          minLength: 3
          pattern: ^(?![=\-\+@]).*
          type: string
        contentPieceHsCode:
          description: 'The HS code of this content. Only 6, 8 or 10 digits, with at most one leading zero.

            HS Code mandatory for all shipments requiring a CN22 customs declaration.'
          example: 1234567890
          type: string
          pattern: ^([0-9]{6}|[0-9]{8}|[0-9]{10})$
        contentPieceIndexNumber:
          description: NOT RECOMMENDED, obsolete and should not be contained in requests until further notice.
          format: int64
          type: integer
        contentPieceNetweight:
          description: The net weight of all pieces of this content type.
          example: 1200
          format: int32
          maximum: 2000
          minimum: 1
          type: integer
        contentPieceOrigin:
          description: Country of origin, based on ISO-3166-1.
          example: DE
          maxLength: 2
          minLength: 2
          pattern: ^(?![=\-\+@]).*
          type: string
        contentPieceValue:
          description: Overall value of the content pieces of one type. 1 to 4 digits before the decimal point, 2 digits after the decimal point or 1 to 7 digits without decimal point
          example: '120.50'
          pattern: ^(?:(?:\d{1,4}\.\d{2})|(?:\d{1,7}))$
          type: string
      required:
      - contentPieceAmount
      - contentPieceDescription
      - contentPieceNetweight
      - contentPieceOrigin
      - contentPieceValue
      - item
      example:
        contentPieceHsCode: 1234567890
        contentPieceDescription: Trousers
        contentPieceValue: '120.50'
        contentPieceNetweight: 1200
        contentPieceOrigin: DE
        contentPieceAmount: 2
    CwsErrorDTO:
      type: object
      properties:
        correlationId:
          type: string
          description: The Correlation ID to track the request through all systems where it has been processed.
          example: b011a094-fade-11e7-8c3f-9a214cf093ae
        messages:
          maxItems: 2147483647
          minItems: 1
          type: array
          description: A list of messages. Any single error is described within a certain message.
          items:
            type: string
            description: A list of messages. Any single error is described within a certain message.
x-refined-from:
- dhl-deutsche-post-international-post-parcel-germany-openapi.yml
- dhl-deutsche-post-international-post-parcel-germany-openapi.yml