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
– test API endpoints in Swagger or Postman

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 the API Farm sandbox: 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.
  7. Go to Applications -> click Register new application
  8. Enter application details and register.
    Your API key (client-key) is shown only once – save it securely.
    Use this key for authentication when testing endpoints in Swagger or Postman.

Start with a simple API such as PostalCodes or ServicePointLocator to verify your setup.

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.

2. Going live – Production

You cannot access production directly.

After testing in sandbox, 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 a production API key.
  3. Submit an Implementation Request.
  4. DHL Freight will review your test requests and activate your production API key. At least one successful test per API is required.

Production APIs create real shipment data. Approval is required before using production APIs.

3. Base URLs

Use the sandbox URL for all testing.

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 requirements:
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 (0771-345 345) with your shipment number.

High Volumes:
For volumes above 10,000 shipments/day, EDI may be more efficient. Contact DHL Freight for guidance.

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