v1
latestSwagger 2.02026-07-1711534.6 KBSearch for DHL Service Point locations by address.
This method will find DHL locations based on an address by first converting the address to a reference point (latitude, longitude) and then finding locations near that point. To convert an address to a reference point, this API uses the Google Geocoding API Address. To optimize results, besides countryCode you need to provide addressLocality and /or postalCode. The more address fields you provide, the better results you may get.
Please read Google Geocoding API Terms of Use: https://cloud.google.com/maps-platform/terms
Limitations: Address fields are not filters. 3rd party Geocoding API hence limited control over results.
Query parameters
A two-letter ISO 3166-1 alpha-2 code (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) specifying the country. https://gs1.org/voc/Country
Text specifying the name of the locality, for example a city. https://gs1.org/voc/addressLocality
Text specifying the postal code for an address. https://gs1.org/voc/postalCode
The street address is expressed as free form text. The street address is printed on paper as the first lines below the name. For example, the name of the street and the number in the street, or the name of a building. https://www.gs1.org/voc/streetAddress
This parameter allows to filter by DPDHL's internal Business Units. When this parameter is specified at least once per request, only locations known by that providerType (a.k.a Business Unit) will be returned. There may be locations with more than one providerType. The available providerTypes are: express (DHL Express Global), parcel (eCommerce Solutions Europe and Post & Parcel Germany)
Type of the DHL Service Point location. This parameter can be added multiple times in each API request. The response will include only locations of the type that matches any of the requested ones.
Each location can offer more than one service. This parameter can be added multiple times in each API request. The response will include only locations with at least all of the serviceTypes requested.
Specifies the radius in meters around the provided location, to search within. Maximum radius: 25 000 meters. Default radius: 500 meters.
Number specifying the maximum amount of locations included in the results. Maximum limit: 50 locations. Default limit: 15 locations.
Response
List of DHL Service Point locations.
Example response
{
"locations": [
{
"url": "/locations/8003-4103535",
"location": {
"ids": [
{
"locationId": "8003-4103535",
"providerType": "parcel"
}
],
"keyword": "Postfiliale",
"keywordId": "443",
"type": "servicepoint"
},
"name": "B+B Tabakwaren",
"distance": "16",
"place": {
"address": {
"countryCode": "DE",
"postalCode": "20095",
"addressLocality": "Hamburg",
"streetAddress": "Mönckebergstr. 7"
},
"geo": {
"latitude": "53.5512589",
"longitude": "10.0023976"
}
},
"openingHours": [
{
"opens": "09:00:00",
"closes": "19:00:00",
"dayOfWeek": "http://schema.org/Monday"
},
{
"opens": "09:00:00",
"closes": "19:00:00",
"dayOfWeek": "http://schema.org/Tuesday"
},
{
"opens": "09:00:00",
"closes": "19:00:00",
"dayOfWeek": "http://schema.org/Wednesday"
},
{
"opens": "09:00:00",
"closes": "19:00:00",
"dayOfWeek": "http://schema.org/Thursday"
},
{
"opens": "09:00:00",
"closes": "19:00:00",
"dayOfWeek": "http://schema.org/Friday"
},
{
"opens": "09:00:00",
"closes": "18:00:00",
"dayOfWeek": "http://schema.org/Saturday"
}
],
"closurePeriods": [],
"serviceTypes": [
"parcel:drop-off",
"parcel:pick-up"
]
},
{
"url": "/locations/8007-420095227",
"location": {
"ids": [
{
"locationId": "8007-420095227",
"providerType": "parcel"
}
],
"keyword": "DHL Packstation",
"keywordId": "227",
"type": "locker"
},
"name": "DHL Packstation 227",
"distance": "473",
"place": {
"address": {
"countryCode": "DE",
"postalCode": "20095",
"addressLocality": "Hamburg",
"streetAddress": "Ballindamm 40"
},
"geo": {
"latitude": "53.5516856",
"longitude": "9.9952905"
}
},
"openingHours": [
{
"opens": "05:30:00",
"closes": "23:00:00",
"dayOfWeek": "http://schema.org/Monday"
},
{
"opens": "05:30:00",
"closes": "23:00:00",
"dayOfWeek": "http://schema.org/Tuesday"
},
{
"opens": "05:30:00",
"closes": "23:00:00",
"dayOfWeek": "http://schema.org/Wednesday"
},
{
"opens": "05:30:00",
"closes": "23:00:00",
"dayOfWeek": "http://schema.org/Thursday"
},
{
"opens": "05:30:00",
"closes": "23:00:00",
"dayOfWeek": "http://schema.org/Friday"
},
{
"opens": "05:30:00",
"closes": "23:00:00",
"dayOfWeek": "http://schema.org/Saturday"
},
{
"opens": "05:30:00",
"closes": "23:00:00",
"dayOfWeek": "http://schema.org/Sunday"
}
],
"closurePeriods": [],
"serviceTypes": [
"parcel:drop-off-unregistered",
"parcel:pick-up-registered"
],
"averageCapacityDayOfWeek": [
{
"dayOfWeek": "Monday",
"capacity": "very-low"
},
{
"dayOfWeek": "Tuesday",
"capacity": "low"
},
{
"dayOfWeek": "Wednesday",
"capacity": "high"
},
{
"dayOfWeek": "Thursday",
"capacity": "high"
},
{
"dayOfWeek": "Friday",
"capacity": "low"
},
{
"dayOfWeek": "Saturday",
"capacity": "very-low"
},
{
"dayOfWeek": "Sunday",
"capacity": "very-low"
}
]
}
]
}