Skip to content

Technical setup

To begin testing DHL APIs, you need to register in API Farm and create an application.

This allows you to:
– access API credentials
– test your integration in sandbox
– use Swagger and Postman tools

1. Registration – Sandbox (test environment)

Use the sandbox environment to develop and test your integration. No real shipments are created and no charges are applied.

  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!

Organisation vs Application

Organisation = your company
Application = the system you are integrating (e.g. your WMS, webshop or TMS)

You need one organisation and one application to get an API key.

After registration, you can test your integration using Swagger and Postman collections.

2. Going live – Production

You cannot access production directly.

After completing sandbox testing, you must submit an Implementation Request. DHL will then prepare your production setup.

  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.

3. Base URL:s

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

4. Postman collections & Flowcharts
Product Postman Collection Flowchart
DHL Servicepoint (103) Download Download
DHL Parcel Connect (109) Download Download
DHL Stycke (211) Download Download
DHL Home Delivery (401-501) Download Download
DHL Hemleverans Paket (118) Download Download

5. Additional Notes

Product Rules:
To understand product limitations and requirements, see the Product Manual or use the Product API for dynamic rule checks.

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.

Questions about registration or technical setup? Contact the integration team via Contact form or email se.dbi@dhl.com.