DHLPost & Parcel GermanydeRESTActive

DHL Post & Parcel Germany API (REST, Germany)

DHL's domestic Germany parcel and post API surface. REST-based, German-language documentation primary, separate credentialing through DHL Geschäftskundenportal. Distinct from MyDHL Express.

The Post & Parcel Germany API is DHL's domestic Germany parcel surface. It replaces the older Geschäftskundenversand SOAP/XML services and is the API integrators use for DHL Paket, DHL Päckchen, and Warenpost shipments originating in Germany. It is not the same API as MyDHL Express, even when both routes appear in the DHL Developer Portal: credentials are issued differently, the contract uses a different shipment vocabulary (Sendung versus shipment), and label formats are German-domestic specific. Authentication uses an API key passed as an HTTP Basic credential, combined with a per-user header that authenticates the underlying Geschäftskundenportal account. Both are required: the API key alone authenticates the integrator, and the Geschäftskundenportal login authenticates the customer whose contract is being used to ship. Misalignment between the two is the most frequent first-time integration failure. Many operational fields are mandatory only for German domestic shipments — Sendungsnummer formats, Postnummer for Packstation deliveries, and the explicit declaration of dangerous goods (Gefahrgut) flags. Schema validation against the DHL OpenAPI document before sending requests turns vague German-language faults into precise local errors. Webhook delivery for delivery and pickup events is available through a separate tracking API.

Surface details

API name
DHL Post & Parcel Germany API
Authentication
HTTP Basic for the API key plus per-user OAuth-style header for the German business-customer login
Production base URL
https://api-eu.dhl.com/parcel/de
Sandbox base URL
https://api-sandbox.dhl.com/parcel/de
Sandbox notes
Sandbox requires both the developer-portal API key and a German business-customer (Geschäftskundenportal) test account. A live API key without a Geschäftskundenportal login cannot create labels.

Frequently asked questions

Can I reuse my MyDHL API credentials with the Post & Parcel Germany API?

No. The two surfaces issue separate credentials and use different authentication models. Post & Parcel Germany also requires a per-user header for the Geschäftskundenportal account that owns the shipping contract.

Where do I get a Geschäftskundenportal login for sandbox?

DHL provides a separate sandbox Geschäftskundenportal account on request through the Developer Portal. Production logins are issued to your DHL business-customer relationship and are managed in the live Geschäftskundenportal.

Is the older Geschäftskundenversand SOAP API still supported?

DHL has been migrating Post & Parcel Germany customers from the legacy SOAP/XML service onto this REST API. Treat the legacy SOAP path as deprecated and check the developer portal for the current sunset schedule.

Related concepts

Sibling carrier surfaces

Tooling and references

Sources

Last reviewed: 2026-04-25