Skip to content

Get started

Prerequisites

DHL Customer Number:

Most APIs require a DHL customer number. Your company must be registered with an organisation number.

API Key:

You’ll receive an API key after registering your organisation and application in API Farm. API keys are GUIDs and must be included in the request header of each API call.

Registration Steps

For Development & Testing

  1. Go to API Farm test environment: test-admin.freight-logistics.dhl.com
  2. Click Sign up and fill in your user details.
  3. Confirm your registration via the email from apifarm@dhl.com
  4. Log in to API Farm
  5. Go to Organisations -> click Create new organisation
  6. Enter your company details and create the organisation.
  7. Go to Applications -> click Register new application
  8. Enter application details and click Register to save.

Your API key (client-key) will be shown on the screen only once – save it securely!

Once testing is complete and successful, proceed to the production environment.

For Production

  1. Go to the production environment: admin.freight-logistics.dhl.com
  2. Sign up and repeat the steps to create your Organisation and Application to retrieve an production API-key.
  3. Submit an Implementation Request.
  4. DHL Freight will review your test data and activate your production API-key. At least one validated test request per API is required.

Important: Production APIs create real shipment data. Approval is mandatory before use.

Base URLs:

Sandbox: https://test-api.freight-logistics.dhl.com…

Production: https://api.freight-logistics.dhl.com…

Additional Notes

Product Rules:

Understand DHL Freight’s product rules and limitations.

Cancellations:

You cannot cancel transports via API or EDI. Cancel in your system and contact DHL Customer Service at 0771-345 345 with your booking/shipment number.

High Volumes:

For more than 10,000 shipments/day, traditional EDI may be more efficient. Contact DHL Freight to discuss.

DHL e-ID:

Required for services linked to your customer number (e.g., contract prices).

Postman collections & examples

Product Download
DHL Servicepoint (103) Download
DHL Servicepoint Return (104) Download
DHL Parcel Connect (109) Download
DHL Parcel Connect Return (107) Download
DHL Stycke (211) Download
DHL Home Delivery (401-501) Download
DHL Hemleverans Paket (118) Download

Contact: se.dbl@dhl.com

Product manuals and specifications are available on the API Farm dashboard.