---
title: "Search for DHL Service Point locations by address."
method: GET
path: "/find-by-address"
tags: ["locations"]
---

# Search for DHL Service Point locations by address.

`GET /find-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

- `countryCode` string, required
- `addressLocality` string
- `postalCode` string
- `streetAddress` string
- `providerType` 'express' | 'parcel'
- `locationType` 'servicepoint' | 'locker' | 'postoffice' | 'postbank'
- `serviceType` 'parcel:pick-up' | 'parcel:drop-off' | 'express:pick-up' | 'express:drop-off' | 'parcel:pick-up-registered' | 'parcel:pick-up-unregistered' | 'parcel:drop-off-unregistered' | 'letter-service' | 'postbank' | 'cash-on-delivery' | 'franking' | 'cash-service' | 'packaging-material' | 'postident' | 'age-verification' | 'handicapped-access' | 'parking' | 'express:drop-off-easy' | 'express:drop-off-prelabeled' | 'express:drop-off-account'
- `radius` number
- `limit` number

## Response `200`

List of DHL Service Point locations.

- SupermodelIoLogisticsPUDOLocations — DHL Service Point location collection
  - `locations` SupermodelIoLogisticsPUDOLocation[]
    - `url` string — The `self` link relation - globally unique identifier of this DHL Service Point location.
    - `location` object
      - `ids` object[] — One location can be known within different business units (providerTypes). They will be known under a unique ID within each business unit domain, as provided.
        - `locationId` string — The ID as how the location is know within this business unit / provider.
        - `provider` string — The business unit of the DHL Service Point location.
      - `keyword` string — Address to put on a label, to send a shipment to a service point or locker for pick up / drop off. For German locations, keyword and keywordId are placed as street name and house number, streetAddress is omitted on the label of a shipment. For locations outside of Germany, keyword and keywordId are placed in addition to streetAddress.
      - `keywordId` string — Id belonging to keyword that together with the keywordId build up the streetAddress for direct addressing to a service point or locker for pick up / drop off.
      - `type` 'servicepoint' | 'locker' | 'postoffice' | 'postbank' — Type of the DHL Service Point location.
    - `name` string — Name of the DHL Service Point location.
    - `distance` number — Distance in meters (m) from the requested geographical coordinates.
    - `place` object
      - `address` object
        - `countryCode` string
        - `postalCode` string
        - `addressLocality` string
        - `streetAddress` string
      - `geo` object — The geo coordinates of the DHL Service Point location.
        - `latitude` number — Latitude
        - `longitude` number — Longitude
    - `serviceTypes` string[] — The list of services available at the DHL Service Point location. - parcel:pick-up - Consumers can pick up DHL Parcel shipments. This applies to last mile. - parcel:drop-off - Consumers can drop off DHL Parcel shipments. This applies to first mile. - express:pick-up - Consumers can pick up DHL Express shipments. This applies to last mile. - express:drop-off - Consumers can drop off DHL Express shipments. This applies to first mile. - parcel:pick-up-registered - Automated locker station for DHL Parcel pick-up for pre-registered consumers (e.g. Parcel Locker, Packstation, SwipBox, Lean Parcel Locker) - parcel:pick-up-unregistered - Automated locker station for DHL Parcel pick-up for unregistered consumers (e.g. Parcel Locker, Packstation, SwipBox, Lean Parcel Locker) - parcel:drop-off-unregistered - Automated locker station for DHL Parcel drop-off for unregistered consumers (e.g. Parcel Locker, Packstation, SwipBox, Lean Parcel Locker) - letter-service - Letter services are offered (e.g. Post Office offering). - postbank - Offering of services of the German financial institution Deutsche Postbank AG, a subsidiary of Deutsche Bank AG. The individual offering can be looked up at Deutsche Postbank AG. - cash-on-delivery - Offering of "cash on delivery". A shipment is only handed over to the recipient against payment. - franking - Offering of labels for franking. This does not include the product "Mobile Paketmarke". - cash-service - Cash service is offered via cash or card payment service. In Germany Giro, Maestro, Postcard and cash payment is supported. - packaging-material - Offering for packing material such as packages for parcels, envelopes for letters, paper, pencils, pens. - postident - Postident is a service to reliably verify the identity of a consumer. This service is commonly used for online bank account identity verification. - age-verification - Reliable verification of the customers age. This service is commonly used to verify that the consumer has reached a specific age for an online offering (e.g. 14 or 18 years). - handicapped-access - Disabled fair access. - parking - Parking area close by.
    - `averageCapacityDayOfWeek` object[] — Indicates the average capacity of the parcel locker on the listed day. If this information is not available, only an aggregated average capacity indication based on the last weeks will be provided as availableCapacity.
      - `dayOfWeek` 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday' — The day of the week as defined at https://schema.org/DayOfWeek
      - `capacity` 'high' | 'low' | 'very-low' | 'unknown' — Information on the average availability of locker capacity (only available in Germany).
    - `availableCapacity` 'high' | 'low' | 'very-low' | 'unknown' — Information on the average availability of locker capacity (only available in Germany).
    - `openingHours` object[] — List of the opening hours of the DHL Service Point location. http://supermodel.io/schemaorg/OpeningHoursSpecification.
      - `closes` string
      - `opens` string
      - `dayOfWeek` string
    - `closurePeriods` object[] — Periods where the DHL Service Point location is closed in the addition to opening hours.
      - `type` string — Reason for the closure
      - `fromDate` string
      - `toDate` string

## Other responses

- `400` — Bad request, for example invalid location type, service type or country.

---

[API](https://skmtc.dev/isa-group/apis/dhl.md) · [All operations](https://skmtc.dev/isa-group/apis/dhl/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/isa-group/dhl/revisions/5072cca891e1/schema)