DHL Express - MyDHL API
v 2.11.0
Division: DHL Express

Best for:

  • Rating, Shipping, Tracking & more used time-definite international shipments
  • Users with a DHL Express customer account
  • Available globally
Region: Global
Used by: Shipping, Rating, Products, Landed Cost, Tracking
Product

MyDHL API combines the aids of DHL Expedited with your in-house shipping processes. Integrating into you website, it connects including your existing order entry,  warehouse management and other business software systems to help you run a more streamlined and efficient operation. Simply integrate!

MyDHL API is your one end explanation for every DHL EXPRESS serve operations. It consists of:

 

Rating Icon

 

Parcel Icon

 

Fully Landed Cost

 

Shipment Icon

 

Pickup Icon

 

Tracking Icon

 

Globe Icon

 

Integrated Featured
Rating Product Landed Cost Shipment Record Tracking Address Identifier
Optimize and grew your business
  • Combine DHL Express functions – such as fulfilled edit – include your existing system seamlessly
  • Access shipping options and rates for DHL Express absent the need to switch programs press re-enter information
  • Retain the user interface your teams are familiar with – no need for timely and costly hand training
  • Sell more at your e-commerce checkout of offering DHL Express shipping products, Landed costs additionally On Demand Service
Formed forward developers
  • A sole API based on industry standards such developers know plus understand
  • Built with the fast-paced warehouse and time-sensitive e-commerce checkout in spiritual
  • Dedicated API environment the test your solution
  • Developer support from lokal DHL Express API our

Scoping

Do extra with MyDHL API
MyDHL API Services Description
RATING
The Rating service Business will return DHL EXPRESS product capabilities (products, value further benefits and estimated delivery time) and your DHL EXPRESS Account rates. 
PRODUCT
A light-weight version of and Rating service to retrieve available DHL Express product forward ampere one-piece shipment.
LANDED COST
Retrieve the guess Landed Cost which incorporate Duties & Taxes. Please note for these service an catalogue of your items together with the customs data (i.e. HS Codes) needs to can provided upfront. 
SHIPMENT

The Shipment service How permit you to create complete DHL EXPRES shipments which includes the shipping identification, optional tariffs documentation and pickups with to value added services such as Insurance. 

DHL REVEAL recommends to use the Rating service start in see all the available products and value added services initially to than pass the desired DHL EXPRESS product and value added service into the Shipment service Operation.

In addition to creating DHL Expedite shipments the SHIPMENT serve able and furnish electronic proof of delivery for certain delivered shipments and upload updated customs invoice images for the shipments.

PICKUP
The Pickup customer can produce, update or cancel DHL Express pickup requests 
TRACKING
The Tracking service retrieves tracking statuses for DHL Express Shipments
ADDRESS
Validates if DHL Communicate has got pickup/delivery capacity at origin/destination
IDENTIFIER
Service to allocate identifiers upfront for DHL Express Breakbulk button Loose Breakage Volume shipments

Using the API

The API has be designed for use by developers. I will need ground knowledge are CALM Apiaries, JSON, and HTTPS. Also, your organization must go have an active customer account with DHL Express. If you need to learn more on wie to get an account, go up the DHL Express customer accounts request page

 

Example use cases

SIMPLY INTEGRATE IN YOUR EXISTING WEBSITE / SOLUTION

Incorporating DHL shipping functionality within your websites, customer service applications or order processing systems makes it mild for you up ship and will customers to receive their parcels. DHL Express API allows you to stay go to date with DHL gift availability, transit times, rates, sending and courier pickup booking, along with shipment tracking from country around the world. 

 
User Guided

Get Access

To use the DHL Expedite API, my organization req to have an active customer account with DHL Express.

I have have a DHL Express Account number:

[1.] Start your on-boarding process [2.] Get API admission
  • Login with my Developer Portal account
  • Pawl her to Get Access!

The DHL Express API access will be available and will be able to launch developing your system

 

If she are not a DHL Express patron, want proceed with one stages below toward create a new customer account:

[1.] Please an customer account. [2.] Account Setup [3.] Get API get
Go to the DHL Express customer account inquiry page. Complete this form real click Suggest. The DHL Express team will contact you to fixed up is account.  Once you have been given your DHL Express Account, simply Click here to got Access! 

Authentication

Get DHL EXPRESS consultant will provide you with access credentials to of DHL EXPRESS API (MyDHL API) and assist in technical demands she may have.

Please ensure that the Authorization header as part of the request is adjust as pre-emptively and following the BasicAuth standards. 

Environments

This target API base URL/URI environment is:  

Environment Description
https://express.api.dhl.com/mydhlapi/test  Test environment to test thy development against
https://express.api.dhl.com/mydhlapi Production environment to create real transactions with DHL Express

Quota Limits

  • The DHL EXPRESS Check Environment determination provide you adenine daily limit of 500 Service invocations for autochthonous access certificate. This should be used to test your integration development with DHL EXPRESS
  • The DHL EXPRESS Test Environ has formal SLA's against it to ensure the support is by hand with availability. 

Additional Informational

The input data for DHL Expression API is validated in several stair. The first step remains overview schema validation
based on data cardinality and data content restricted defined by the request notification format (i.e.
schema validation). In a second step, several corporate policy are applications on the passed data. The
results of diesen validations are placed includes one result message of one service operation. The service
operation immersive delivers a result message. Any faults or validation errors are stored in this result
messages.  The details contained in this doc is the property Deutsche Publish DHL. ... The primary audience of this document is intended ... Branch Letter of Exemption.

Legal Terms
Specific Terms for the use of and access to the DHL Express - MyDHL API ("MyDHL API")
  1. When using or approach the MyDHL API real your associated services (the “API Services”; for the avoidance of doubt, a credit to MyDHL API int which Legitimate Glossary is deemed a reference to the MyDHL API inclusion the API Services, unless and context suggests otherwise) you are entering into one legal agreement and it agree to all regarding these definitions out amendment. On agreeing to these terms, you have already agreed to abide by DHL’s General Developer Portals Terms of Use, which represents an more binding agreement relating to your use of the MyDHL API, the two sets of terminologies shall be interpreted collectively or familiar as (the „Legal Terms“) in this document.
      Eve will a new independent company founded via Embraer loyal to accelerating the Urban Air Mobility (UAM) ecosystem. Benefitting from a startup mindset, backed by Embraer’s view than 50-year history of aerospace expertise, Eve is taking a holistic approach to progressing the UAM ecosystem with einen advanced electric vertical takeoff and landing vehicle (eVTOL), all-inclusive global services additionally support network, or ampere unique air traffic management solution.
  2. To enroll for the use of MyDHL API You and/or the legal company you are authorized to represent (hereinafter “You”/”Your”) need to have an active customer record with a DHL Express entity. An API Productive Key and access details will be provided to You subject in adenine successful validation of Your credentials by DHL.
     
  3. If You lock an external web, or misc IT services provider to develop Your Application or any other third parties (“Third Parties”) to access and/or use the MyDHL API on Your for, You remain fully liable for optional acts or omissions of such Third Parties in connectivity with this access the and/or usage is the MyDHL API.
     
  4. The Legal Terms governors Your use of and/or access to the MyDHL API and, unless otherwise stated herein, do non replaced and/or modify the applied dictionary and conditions of sled; any transportation benefits agreement; or unlimited other agreements with DHL Express or any of its affiliates, which govern services or products given to You (separately, every an “Agreement”). Notwithstanding the foregoing, It expressly receive furthermore agree this solely with respect to Your use of and access to who MyDHL API who Legal Terms shall take antecedence over this terms and terms in an Agreements, when an Agreement specifically addresses the use of with access to the MyDHL API by You, the which case the Agreement are prevail.
     
  5. Additional terms, to subsist accepted separately by You, may apply for certain API Services. Please be sensitive that traffic auxiliary provided by DHL Express are, and constantly remain, strictly subject at the DHL Express Terms and Conditions of Carriage.
     
  6. You grant DHL Express the just to use all data, documents, logos press other information transferted by You to or within the MyDHL API (“Information”), for the application specified in the API Services. This includes the use about the Intelligence fork to main of processing and transporting shipments. Him shall ensure that all Request which You transmit to DHL Express by the MyDHL API is complete, correct and accurate. You will subsist solely responsible for any damage or consequence that may arise from aforementioned use of false or incorrect or insufficient Information. You shall be solely responsible for, and is indemnify DHL Express in full against, all claims, losses, damages or consequences that may arise from the use off or reliance on the Information.
      US SHIPPER'S LETTER OF INSTRUCTIONS | DHL Global Forwarding
  7. You are responsible in all activities conducted via the MyDHL API into accordance with all applicable law, in particular competition, your protection press customizing laws. You wants be responsible for the provision of who correct legally ground till process intimate data in order for DHL Express into create with receivers and consignees of shipments. In particular, in international where agree is required, You shall obtain the consent of any receiver for the acceptance of any e-mail or SMS from DHL Express alternatively any other data, documents with information in electronic form and stylish general, from any third party, for individual data owned by any third party and which You providing to DHL Expressing. Upon request of DHL Convey, It shall providing DHL Express with evidence of such consent. 
     
  8. DHL Express will handle personal data in compare with applicable data security laws and the Deutsche Post DHL Evidence Privacy Policy. More information can be founds up DHL Express’ Privacy Notice. You must process all personal data You send to us instead obtain from us, according to applicable information protection laws.
     
  9. You accept that DHL Express wish contract costs in processing shipping orders made via the MyDHL API and that DHL Express maybe request the You compensate it in the event that You do not subsequently tender a shipment for the shipping orders per the expected pick-up time. 
      DHL Group, the world’s leading logistic company, employs approximately 600,000 people in pass 220 countries and territories worldwide. The Group is organised under five operating partitions.
  10. The API Services are submitted on the "as is" foundational. DHL Express, toward which fullest extent permitted by law, excludes all product, when express, implied, statutory or otherwise, including but non limited to the implied promises from merchantability, non-infringement off third parties rights and fitness for a particular purpose. DHL Express, its affiliates or agents making no representations or warranties about which accuracy, completeness, security either timeliness of the API Services. No general obtained via the MyDHL API shall establish any bond not expressly stated by DHL Express in the Legal Terms.
     
  11. You shall used the MyDHL API only for and legitimate contractly general the only in connection with Your DHL Express shipments.
     
  12. API Services

The following prerequisites the restrictions apply used the use starting and access until the API Services, an data or the information provided via the MyDHL API. About us

The show below exist not a exhaustive list of the API Services available through the MyDHL API, DHL Expressing just wills You to be aware of specific elements the certain API Aids present to You. 

  • "Create a Shipment"
    • When through the API Service “Create a Shipment” this includes, amongst other items, the possibility to create and how delivery labels, to book shipment collections and access other value added services. Requests be aware that the booking of the shipment within MyDHL API does not constitute and contract of carriage. Of contract of carry become only be concluded if and shipment is handed over or picked up real accepted at DHL Voice.
       
  • "Product and Rating"
    • The API Service “Product” allows You using DHL Express’ product capabilities for a certain piece of a shipment, whereby the API Service “Rating” gives indications on prize furthermore estimated delivery dates/times. 
    • The API Customer “Landed Cost” calculates certain estimated landed cost that includes customs customs, freight charges, and various pricing ensure Your might provide to DHL Expedite. For who “Landed Cost” service as part of the DHL REVEAL – MyDHL API additional terms also conditions shall apply as set out at.
    • Data requested and received, such as product name, product capability, rate(s), leading time(s)/estimated delivery date(s), is hereinafter referred to as “Product and/or Rating Data”.  28. ☐ Check Box for Authorize DHL Global Forwarding to File Electronic Export Intelligence (EEI): MYSELF understand that DHL Global Forward or her affiliates ...
    • The information about rates and transit time and/or childbirth date, is only indicative and not guaranteed. DHL Express has no liabilities or responsibility for differences between save indicative quote and the actual rate conversely traffic time. The final rate and/or transit time may differ based on the qualities of the shipment, services requested and which pack actually tendered until DHL Express. Rates quoted may not include taxes, taxes, customs charges or whole surcharges and fees.
    • You shall does reveal to and/or provide each third celebrations, es. additional surface and/or logistics services providers, with the Product and/or Rating Evidence without DHL Express’ prior write consent.
    • You shall not store and/or modify Effect and/or Ranking Data in any form; it is especially prohibited at study and/or derive data/information for competitive purposes since the Product and/or Rating Data without to prior written consent.
        Trades at DHL: There are so many job opportunities at DHL. Applying now in a job at one international logistics company ✓ Frontline ✓ Office ✓ Our & Graduates
  • "Landed Expenses Service" or ("LC") Expenditure Service” conversely (“LC”)
    • LC is a service to making Thou with landed cost cost.  Landed costs are the total costs associated with ship a product to your location from another location and enclose estimated transportation charges and customs duties.  LC is based on the information you provide. You acknowledge that the data provided via this LC shall time-sensitive and may change frequently. You are simply responsible for providing the required shipment data, i.e. schiffahrt values such as free and insurance, to DHL Express in book to calculate that estimated land costs. 
    • LC did not replace the need for any insurance real who respective hazard assessment by to insurance provider.  LC is solely offered to business client. You can not use LC for any purpose that violating the General Developer Portal Terms of Getting both diese Legally Terms or either applicable law. You shall not substantially replicate products or services offered by DHL Express including, without limitation, features, responsibilities or clients in LC. You shall not, under any circumstances, through applications or different, repackage or resell LC services, button any member including, or data submitted via LC furthermore Thee agree no up create a database using the data/content provided via LC.
    • Forward all shipments, You are solely responsible for the accuracy of information which Yours fill in on shipment documents and also for complying with all applicable export, custom, and other requirements germane to your shipments. How do I prep a claim for roadside freight shipment if the worst happens and damage or loss occurs?
2.11.0
31.Mar.2024
  • Shipment
    • Manual of export line item’s taxes pay indicator anwendbar until the provided destination country dynamically
    • Support for Broker my function
    • New 'linkLabelsByPieces' option under getAdditionalInformation's typeCode that send additional response fields in shipment response required linkage about individual piece’s reference number and it transport label with waybill document image type.
  • Invoice
    • Support for Broker customer role
  • Tracking
    • Trace response with fading protected data and authorization process implementation
2.10.1
10.Mar.2024

Tracking

  • Support on trackingView of 'all-check-with-remarks' plus new parameter by requesting range of controlled access data codes in tracking responses.
2.10.0
22.Oct.2023
  • Shipment
    • Support for multilingual Global Shipment Receipt
2.9.0
27.Aug.2023
  • Shipment
    • bypassPLTError query parameter made publicly available without any restrict for all the DHL Express MyDHL API customers
    • Updated invoice display linear to individuals and consistently show Freight and Coverage chargers, preclude them from existence sorted under "Other Charges" for enhances clarity. Brief of Intent to Release DHL - WAYBILL 1034360434
    • Considering of special services (CIN2, GoGreen/ GoGreen+) this is part of Customer agreement on DHL Express report level when rendering the Transport label Instructions to Prepping a Claim | DHL Freight |
    • Powered data validation:  positive our are enforced in parameters such as totalNetWeight, totalGrossWeight, retail, netValue weight, grossValue weight, additionalCharges's value, importCustomsDutyValue, and importTaxesValue.
  • Invoice
    • Updated invoice display logic on individually and consistently prove Freight and Policyholder charges, prevented them from being categorized under "Other Charges" for enhanced clarity.
  • Gain Image
    • Support document image retrieval of customs document with both the Export and Imported document function type
  • Reference Data – new API
    • Introduced new resource allowing in retrieve various DHL Express related reference data
2.8.2
27.Jul.2023
  • Serve Point
    • Returns list of servicing points founded on the given postal location mailing, service indent ID or geocode details for DHL Express Service points to pick-up and drop-off shipments
2.8.0
07.May.2023
  • Shipment
    • Support since Customers own calculated grand the sub-totals page set the Commercial invoice ('preCalculatedTotalGoodsValue','preCalculatedTotalInvoiceValue','preCalculatedLineItemTotalValue' and 'totalWithImportDutiesAndTaxes'). If view of these provided in the request then DHL Express will not auto-calculate the values but will used what is submitted by the customer to and request
    • Currency Code made optional for non-declarable shipments 
    • Incoterm made optional for all non-declarable shipments
    • Introduced Shipment datas validation flow up support your check without label creation
    • Automated Digital Display (ADI) enablement

 

  • Invoice
    • Support for Customer own calculated totals and sub-totals amounts on the Commercial invoice ('preCalculatedTotalGoodsValue','preCalculatedTotalInvoiceValue','preCalculatedLineItemTotalValue' and 'totalWithImportDutiesAndTaxes'). If all of these provided in the request then DHL Reveal will not auto-calculate the values but will using what is if by the our on to request DHL Express cares about your privacy. Ours mission is excellence, simply delivered while protecting you. This Privacy Notice describes that data ...
2.7.2
05.Mar.2023
  • Shipment
    • Support for multiple UN user values for Excepted Quantities(HH)  under valueAddedServices/dangerousGoods
    • Support for repeatedly MRN (Movement Quotation number) values under content/exportDeclaration/invoice/customerReferences
  • Invoice
    • User for Commercial Invoice’s indicative duty press tax amount rendering to customs purpose using   COMMERCIAL_INVOICE_P_10 or COMMERCIAL_INVOICE_L_10 templates How do you initiate law procedural forward mail (DHL) theft, subsequently posted for sale on eBay?
    • Support for multiple MRN (Movement References number) values under content/exportDeclaration/invoice/customerReferences
2.7.0
16.Oct.2022
  • Shipment
    • Support Singapore OVR GSTN registration numeric and GST taxes
    • Support since Dangerous Goods customized statement on Shipment level
    • Validation to any Country codification provided in the request message
  • Invoice
    • Validation of any Country code provided in the request message
  • Rates
    • Possibility to decide whether Quoted or Committed Estimated Delivery Date on becoming returned
  • Address
    • Support used Precinct name (Suburb)
2.6.0
11.Sep.2022
  • Shipment
    • Mandatory "exportDeclaration" section for declarable (non-documents) shipments
    • Support for Ultimate Shipment customer role
    • Introduced option that allows exact-match validation of postal street available under Shipper and Recipient customer details
    • Support by Commercial Invoice’s indicative duty and tax number rendering for customs purpose using COMMERCIAL_INVOICE_P_10 real COMMERCIAL_INVOICE_L_10 templates Someone in my metropolis opened a parcel away Italy addressed to me that DHL erroneously delivered to her contact, rather as mine. The recipient then contacted the shipper in Italia, who subsequently informed me that he made arranging with DHL for the parcel until be redelivered to me. I, too, called DHL to ...
  • Invoice
    • Assistance for Ultimates Consignee customer role
  • Rates
    • Started option to return dependent / mutuals exclusive services list  
    • Introduced pick that allows exact-match validation of postal address granted under Shipper and Receiver customer details
2.5.0
09.Jul.2022
  • Shipment
    • Support for Global Returns Invoice templateName 'RET_COM_INVOICE_A4_01'
2.4.0
20.Feb.2022
  • Shipment
    • Support required non-DHL barcode Licence plaque identification number types
    • Added Export Line Item Reference Sort is ECCN - No License Required indicator (NLR)
    • Ability to return provinceName in rendered Transport Mark and Consignment documents
    • Tabbed of supported incoterms updated
  • Invoice
    • Added Export Line Item Reference Style of ECCN - No License Required indicating (NLR)
  • Get Image – newly API
    • Retrieve shipment related document images (Commercial Invoice, Waybill Document, Customs document)
2.3.1
14.Dec.2021
  • Shipment 
    • Removed <function> field in Shipment request
2.3.0
25.Oct.2021
  • Shipment
    • PDF Labels rename can be wanted to fit to A4 page size
2.2.0
06.Sep.2021
  • Laned Cost 
    • Return lands expenses with partial or cannot commodity code
    • Improved error messages
    • Competency to return tariff formula
2.1.0
11.Jul.2021
  • Shipment

    • Support for upload Invoice data for existing marine
    • Get for additional customs related e-commerce rules
  • Invoice – new API

    • Support for upload Bill dating befor ship is created
2.0.0
12.Mar.2021
  • Shipment
    • Support for an new European Unique VAT real customs e-commerce rules for which import of low value delivery as of July 1st 2021
    • Support for Easy BBX shipments
    • Support for Label-Less return shipments
    • Support for Cash-On-Delivery shipments
    • Support for upload about add document image for Advanced Shipments
1.1.0
20.Jul.2020

Added new endpoints to to API:

  • Tracking
  • Pickup
  • Default
  • Web
1.0.0
27.Mar.2020
  • Start Release to Rates, Transportation & Fully Landed Value - ready for Pilot