Reference · built on requestConnectorShipping & logistics

DHL Express

Rates, products, landed cost, shipments with customs documents, pickups, and tracking from the DHL Express MyDHL API.

About

DHL Express is the international time-definite arm of DHL. Its MyDHL API, published on the DHL API Developer Portal at version 3.3.2, covers rating, products, landed cost, shipment creation with customs paperwork, pickup booking, tracking, electronic proof of delivery, and service points. One tracking call accepts up to 200 shipment tracking numbers. Access uses Basic Authentication with credentials issued by your DHL Express consultant.

On Fibric, an operator follows cross-border shipments against the products you sold, proposes the commercial invoice data upload when customs holds a parcel, and proposes a pickup when labeled shipments are waiting to leave.

This is a reference listing. It documents what Fibric would read from DHL Express and what it could propose, based on the vendor's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Tracking status for one or many DHL Express shipments via GET /tracking, up to 200 tracking numbers per request
  • Electronic Proof of Delivery for a shipment via GET /shipments/{shipmentTrackingNumber}/proof-of-delivery
  • Account-based rates for one-piece (GET /rates) and multi-piece (POST /rates) shipments
  • Available DHL Express products for a one-piece shipment via GET /products
  • Estimated landed cost, including duties and taxes, via POST /landed-cost
  • Whether DHL Express can pick up or deliver at an origin or destination via GET /address-validate
  • Nearby DHL service points via GET /servicepoints

Proposed actions

  • Target capability: propose a shipment through POST /shipments, with the label, waybill, and customs documents returned for review
  • Target capability: propose a pickup booking through POST /pickups, an update through PATCH, or a cancellation through DELETE /pickups/{dispatchConfirmationNumber}
  • Target capability: propose uploading commercial invoice data for a shipment through PATCH /shipments/{shipmentTrackingNumber}/upload-invoice-data
  • Target capability: propose adding a piece to an existing shipment through PATCH /shipments/{shipmentTrackingNumber}/add-piece

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Clear a customs hold faster

    When tracking shows a shipment held for paperwork, propose the commercial invoice data upload with the values from the order, ready for approval.

    With Customs Declaration

  • Keep the delivery promise on international orders

    Compare the product available for the lane with the date promised at checkout and propose a customer notice when it cannot be met.

    With Promise Date, Carrier Exception

  • Resolve a delivery dispute with ePOD

    Fetch the Electronic Proof of Delivery for a contested shipment and propose attaching it to the customer's case.

    With Delivery Dispute

Requirements

  • An active customer account with DHL Express, requested through the DHL Express customer portal if you lack one
  • MyDHL API credentials from your DHL Express consultant, first for the test environment, then for production
  • Shipper and receiver details, declared contents, and your account number on rate, landed cost, and shipment requests
Authentication
Basic Authentication on every request, using the MyDHL API credentials your DHL Express consultant issues; the specification also defines an X-API-KEY header scheme.

Limits

  • The test environment allows 500 service invocations per day for a set of credentials
  • In test, tracking works only for the sample waybill numbers DHL loads; shipments you create there cannot be tracked
  • The MyDHL API has no webhook; tracking is fetched on request
  • Landed cost figures are estimates of duties and taxes, as DHL labels them

Access and pricing

Reference listing. Fibric builds the connector under a managed deployment when you request it. Your quote covers the build, capabilities, usage, and support.

Request DHL Express ↗

Questions and answers

Does the MyDHL API include webhooks?
No. Tracking is a GET request to /tracking or /shipments/{shipmentTrackingNumber}/tracking. One call accepts up to 200 tracking numbers, so Fibric fetches status on a schedule rather than waiting for a push.
How do I get MyDHL API credentials?
You need an active DHL Express customer account. Your DHL Express consultant provides the access credentials and helps with technical questions. Test runs at express.api.dhl.com/mydhlapi/test with a limit of 500 invocations per day; production is express.api.dhl.com/mydhlapi.
Can the API handle customs paperwork?
Yes. POST /shipments returns customs documents with the label, including paperless trade options. Commercial invoice data can be uploaded for an existing shipment, and POST /landed-cost returns estimated duties and taxes before you ship.
Ask about DHL Express

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.