New

Just launched: Vueblocks, a brand-new search engine for Vue packages! Explore Vueblocks →

smart-dato/dhl-unified-sdk

Laravel SDK for the DHL developer portal APIs authenticated with a DHL-API-Key (Location Finder Unified)
5,111
Install
composer require smart-dato/dhl-unified-sdk
Latest Version:0.0.1
PHP:^8.4
Laravel:11 · 12 · 13
License:MIT
Last Updated:Nov 9, 2026
Links: GitHub  ·  Packagist
Maintainer: smart-dato

DHL Unified SDK

Latest Version on Packagist Total Downloads

Laravel SDK, built on Saloon, for the DHL developer portal APIs that authenticate with a plain DHL-API-Key header.

Supported today:

Installation

composer require smart-dato/dhl-unified-sdk

Publish the config file:

php artisan vendor:publish --tag="dhl-unified-sdk-config"
return [
    'api_key' => env('DHL_UNIFIED_API_KEY'),
    'base_url' => env('DHL_UNIFIED_BASE_URL', 'https://api.dhl.com'),
    'delay_ms' => (int) env('DHL_UNIFIED_DELAY_MS', 0),
];

The API key comes from an app on developer.dhl.com that is subscribed to the APIs you call.

Usage

use SmartDato\DhlUnified\DhlUnified;
use SmartDato\DhlUnified\Enums\LocationType;

$dhl = app(DhlUnified::class); // from config
$dhl = DhlUnified::make(['api_key' => '...', 'delay_ms' => 1000]); // explicit

$lockers = $dhl->locations()->findByGeo(
    latitude: 50.72,
    longitude: 7.11,
    countryCode: 'DE',
    radiusInMeters: 5000,
    limit: 50,
    locationType: LocationType::Locker,
);

$lockers[0]->id();                   // "8003-4103145", id of the unified record
$lockers[0]->location->keyword;      // "Packstation"
$lockers[0]->location->keywordId;    // "145", used when addressing a shipment
$lockers[0]->place->address->postalCode;

$dhl->locations()->findByAddress(countryCode: 'DE', postalCode: '53113');
$dhl->locations()->get('8003-4103145');

The Location Finder returns the nearest locations up to limit (max 50). It has no paging and no bulk download.

Errors

Every non-2xx response throws SmartDato\DhlUnified\Exceptions\DhlUnifiedApiException. A 429 throws its subclass RateLimitExceededException, so callers can stop and resume once the quota resets (the initial service level is 500 calls per day).

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

The MIT License (MIT). Please see License File for more information.

Related Packages

smart-dato/dhl-parcel-sdk

Laravel SDK for the DHL Parcel DE Shipping v2 API

10,117 1
smart-dato/dhl-parcel-returns-sdk

Laravel SDK for the DHL Parcel DE Returns API

9,395 0
smart-dato/asendia-sync-sdk

Laravel SDK for the Asendia Sync shipping API (parcels, labels, manifests, track...

1,321 0
crescat-io/saloon-sdk-generator

Simplified SDK Scaffolding for Saloon

36,596 138
smart-dato/eushipments

EuShipments Laravel SDK

10,992 0

Version History

Version Released PHP Laravel License
0.0.1 ^8.4 ^11.0||^12.0||^13.0 MIT