DHL Location Finder Virtual Sandbox

Access Deutsche Post DHL Group service point locations and PUDO information.

The DHL Location Finder API allows developers to retrieve Service Point locations, including pick up and drop off (PUDO) points. It supports searching by address, geographic coordinates, or specific keywords to integrate logistics location data into applications.

Use this hosted sandbox to simulate DHL Location Finder APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready. This keeps your integration code consistent across local development, QA, demos, and production.

Use cases:

Use this sandbox to validate location search queries, handle coordinate-based proximity results, test address-to-location mapping, and verify the rendering of service point details and operational metadata in your logistics application.

DHL Location Finder virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate DHL Location Finder responses instantly.

`https://dhl-location-finder.mock.beeceptor.com`

locations(4 operations)

GET

/location-finder/v1/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

Query Parameter Name	Example
`countryCode`*	`DE`
`addressLocality`	`Bonn`
`postalCode`	`53113`
`streetAddress`	`Charles-de-Gaulle-Str. 20`
`providerType`	`["express","parcel"]`
`locationType`	`["pobox"]`
`serviceType`	`["franking"]`
`radius`	`2500`
`limit`	`20`
`hideClosedLocations`	`false`
`currentDate`	`24-01-2023`

Request Payload

Response Payload

{
  "locations": [
    {
      "averageCapacityDayOfWeek": [],
      "closurePeriods": [],
      "distance": 255,
      "location": {
        "dfLocker": false,
        "ids": [
          {
            "locationId": "8003-4008202",
            "provider": "parcel"
          }
        ],
        "keyword": "Postfiliale",
        "keywordId": "502",
        "leanLocker": false,
        "type": "postoffice"
      },
      "name": "Postfiliale 502",
      "openingHours": [
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Monday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Tuesday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Wednesday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Thursday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Friday",
          "opens": "08:00:00"
        },
        {
          "closes": "12:00:00",
          "dayOfWeek": "https://schema.org/Saturday",
          "opens": "10:00:00"
        }
      ],
      "place": {
        "address": {
          "addressLocality": "Bonn",
          "countryCode": "DE",
          "postalCode": "53113",
          "streetAddress": "Charles-de-Gaulle-Str. 20"
        },
        "geo": {
          "latitude": 50.71601,
          "longitude": 7.129804
        }
      },
      "routingDistance": {
        "distance": 1500,
        "distanceType": "routing-by-car"
      },
      "serviceTypes": [
        "parcel:pick-up",
        "parcel:drop-off-unlabeled",
        "postident",
        "express:drop-off-easy",
        "parcel:drop-off-firstmile-unlabeled",
        "parcel:drop-off-firstmile",
        "express:drop-off",
        "parcel:drop-off-return-unlabeled",
        "parcel:drop-off-return",
        "express:drop-off-account",
        "cash-on-delivery",
        "express:drop-off-unlabeled",
        "express:drop-off-prelabeled",
        "parcel:drop-off",
        "parking",
        "age-verification",
        "express:pick-up",
        "letter-service"
      ],
      "url": "/locations/8003-4008202"
    },
    {
      "averageCapacityDayOfWeek": [
        {
          "capacity": "very-low",
          "dayOfWeek": "Monday"
        },
        {
          "capacity": "low",
          "dayOfWeek": "Tuesday"
        },
        {
          "capacity": "high",
          "dayOfWeek": "Wednesday"
        },
        {
          "capacity": "high",
          "dayOfWeek": "Thursday"
        },
        {
          "capacity": "low",
          "dayOfWeek": "Friday"
        },
        {
          "capacity": "very-low",
          "dayOfWeek": "Saturday"
        },
        {
          "capacity": "very-low",
          "dayOfWeek": "Sunday"
        }
      ],
      "closurePeriods": [],
      "distance": 473,
      "location": {
        "ids": [
          {
            "locationId": "8007-420095227",
            "provider": "parcel"
          }
        ],
        "keyword": "DHL Packstation",
        "keywordId": "227",
        "type": "locker"
      },
      "name": "DHL Packstation 227",
      "openingHours": [
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Monday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Tuesday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Wednesday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Thursday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Friday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Saturday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Sunday",
          "opens": "08:00:00"
        }
      ],
      "place": {
        "address": {
          "addressLocality": "Hamburg",
          "countryCode": "DE",
          "postalCode": "20095",
          "streetAddress": "Ballindamm 40"
        },
        "geo": {
          "latitude": 53.5516856,
          "longitude": 9.9952905
        }
      },
      "routingDistance": {
        "distance": 650,
        "distanceType": "routing-by-car"
      },
      "serviceTypes": [
        "parcel:drop-off-unregistered",
        "parcel:pick-up-registered"
      ],
      "url": "/locations/8007-420095227"
    }
  ]
}

{
  "status": 400,
  "title": "Unknown Service Type",
  "detail": "Provided serviceType xyz is not known."
}

{
  "status": 401,
  "title": "Unauthorized",
  "detail": "Invalid token"
}

{
  "status": 500,
  "title": "Internal Server Error."
}

GET

/location-finder/v1/find-by-geo

Search for DHL Service Point locations by geo coordinates

Query Parameter Name	Example
`latitude`*	`50.7160027`
`longitude`*	`7.1300817`
`providerType`	`["express"]`
`locationType`	`["locker","postbox"]`
`serviceType`	`["express:drop-off-prelabeled","express:drop-off-prelabeled"]`
`radius`	`2500`
`limit`	`20`
`countryCode`	`DE`
`hideClosedLocations`	`false`
`currentDate`	`24-01-2023`

Request Payload

Response Payload

{
  "locations": [
    {
      "averageCapacityDayOfWeek": [],
      "closurePeriods": [],
      "distance": 255,
      "location": {
        "dfLocker": false,
        "ids": [
          {
            "locationId": "8003-4008202",
            "provider": "parcel"
          }
        ],
        "keyword": "Postfiliale",
        "keywordId": "502",
        "leanLocker": false,
        "type": "postoffice"
      },
      "name": "Postfiliale 502",
      "openingHours": [
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Monday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Tuesday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Wednesday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Thursday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Friday",
          "opens": "08:00:00"
        },
        {
          "closes": "12:00:00",
          "dayOfWeek": "https://schema.org/Saturday",
          "opens": "10:00:00"
        }
      ],
      "place": {
        "address": {
          "addressLocality": "Bonn",
          "countryCode": "DE",
          "postalCode": "53113",
          "streetAddress": "Charles-de-Gaulle-Str. 20"
        },
        "geo": {
          "latitude": 50.71601,
          "longitude": 7.129804
        }
      },
      "routingDistance": {
        "distance": 1500,
        "distanceType": "routing-by-car"
      },
      "serviceTypes": [
        "parcel:pick-up",
        "parcel:drop-off-unlabeled",
        "postident",
        "express:drop-off-easy",
        "parcel:drop-off-firstmile-unlabeled",
        "parcel:drop-off-firstmile",
        "express:drop-off",
        "parcel:drop-off-return-unlabeled",
        "parcel:drop-off-return",
        "express:drop-off-account",
        "cash-on-delivery",
        "express:drop-off-unlabeled",
        "express:drop-off-prelabeled",
        "parcel:drop-off",
        "parking",
        "age-verification",
        "express:pick-up",
        "letter-service"
      ],
      "url": "/locations/8003-4008202"
    },
    {
      "averageCapacityDayOfWeek": [
        {
          "capacity": "very-low",
          "dayOfWeek": "Monday"
        },
        {
          "capacity": "low",
          "dayOfWeek": "Tuesday"
        },
        {
          "capacity": "high",
          "dayOfWeek": "Wednesday"
        },
        {
          "capacity": "high",
          "dayOfWeek": "Thursday"
        },
        {
          "capacity": "low",
          "dayOfWeek": "Friday"
        },
        {
          "capacity": "very-low",
          "dayOfWeek": "Saturday"
        },
        {
          "capacity": "very-low",
          "dayOfWeek": "Sunday"
        }
      ],
      "closurePeriods": [],
      "distance": 473,
      "location": {
        "ids": [
          {
            "locationId": "8007-420095227",
            "provider": "parcel"
          }
        ],
        "keyword": "DHL Packstation",
        "keywordId": "227",
        "type": "locker"
      },
      "name": "DHL Packstation 227",
      "openingHours": [
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Monday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Tuesday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Wednesday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Thursday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Friday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Saturday",
          "opens": "08:00:00"
        },
        {
          "closes": "17:00:00",
          "dayOfWeek": "https://schema.org/Sunday",
          "opens": "08:00:00"
        }
      ],
      "place": {
        "address": {
          "addressLocality": "Hamburg",
          "countryCode": "DE",
          "postalCode": "20095",
          "streetAddress": "Ballindamm 40"
        },
        "geo": {
          "latitude": 53.5516856,
          "longitude": 9.9952905
        }
      },
      "routingDistance": {
        "distance": 650,
        "distanceType": "routing-by-car"
      },
      "serviceTypes": [
        "parcel:drop-off-unregistered",
        "parcel:pick-up-registered"
      ],
      "url": "/locations/8007-420095227"
    }
  ]
}

{
  "status": 400,
  "title": "Unknown Service Type",
  "detail": "Provided serviceType xyz is not known."
}

{
  "status": 401,
  "title": "Unauthorized",
  "detail": "Invalid token"
}

{
  "status": 500,
  "title": "Internal Server Error."
}

GET

/location-finder/v1/find-by-keyword-id

Search for DHL Service Point locations by keywordId

Query Parameter Name	Example
`keywordId`*	`502`
`countryCode`*	`DE`
`postalCode`*	`53113`

Request Payload

Response Payload

{
  "url": "/locations/8003-4008202",
  "location": {
    "ids": [
      {
        "locationId": "8003-4008202",
        "provider": "parcel"
      }
    ],
    "keyword": "Postfiliale",
    "keywordId": "502",
    "type": "postoffice",
    "leanLocker": false,
    "dfLocker": false
  },
  "name": "Postfiliale 502",
  "distance": 255,
  "routingDistance": {
    "distance": 1500,
    "distanceType": "routing-by-car"
  },
  "place": {
    "address": {
      "countryCode": "DE",
      "postalCode": "53113",
      "addressLocality": "Bonn",
      "streetAddress": "Charles-de-Gaulle-Str. 20"
    },
    "geo": {
      "latitude": 50.71601,
      "longitude": 7.129804
    }
  },
  "openingHours": [
    {
      "opens": "08:00:00",
      "closes": "17:00:00",
      "dayOfWeek": "https://schema.org/Monday"
    },
    {
      "opens": "08:00:00",
      "closes": "17:00:00",
      "dayOfWeek": "https://schema.org/Tuesday"
    },
    {
      "opens": "08:00:00",
      "closes": "17:00:00",
      "dayOfWeek": "https://schema.org/Wednesday"
    },
    {
      "opens": "08:00:00",
      "closes": "17:00:00",
      "dayOfWeek": "https://schema.org/Thursday"
    },
    {
      "opens": "08:00:00",
      "closes": "17:00:00",
      "dayOfWeek": "https://schema.org/Friday"
    },
    {
      "opens": "10:00:00",
      "closes": "12:00:00",
      "dayOfWeek": "https://schema.org/Saturday"
    }
  ],
  "closurePeriods": [],
  "serviceTypes": [
    "parcel:pick-up",
    "parcel:drop-off-unlabeled",
    "postident",
    "express:drop-off-easy",
    "parcel:drop-off-firstmile-unlabeled",
    "parcel:drop-off-firstmile",
    "express:drop-off",
    "parcel:drop-off-return-unlabeled",
    "parcel:drop-off-return",
    "express:drop-off-account",
    "cash-on-delivery",
    "express:drop-off-unlabeled",
    "express:drop-off-prelabeled",
    "parcel:drop-off",
    "parking",
    "age-verification",
    "express:pick-up",
    "letter-service"
  ],
  "averageCapacityDayOfWeek": []
}

{
  "status": 400,
  "title": "Unknown Service Type",
  "detail": "Provided serviceType xyz is not known."
}

{
  "status": 401,
  "title": "Unauthorized",
  "detail": "Invalid token"
}

{
  "status": 404,
  "title": "Location not found",
  "detail": "Location with provided keyword ID could not be found."
}

{
  "status": 500,
  "title": "Internal Server Error."
}

GET

/location-finder/v1/locations/{locationId}

Retrieve one DHL Service Point location by its ID

Request Payload

Response Payload

{
  "url": "/locations/8003-4008202",
  "location": {
    "ids": [
      {
        "locationId": "8003-4008202",
        "provider": "parcel"
      }
    ],
    "keyword": "Postfiliale",
    "keywordId": "502",
    "type": "postoffice",
    "leanLocker": false,
    "dfLocker": false
  },
  "name": "Postfiliale 502",
  "distance": 255,
  "routingDistance": {
    "distance": 1500,
    "distanceType": "routing-by-car"
  },
  "place": {
    "address": {
      "countryCode": "DE",
      "postalCode": "53113",
      "addressLocality": "Bonn",
      "streetAddress": "Charles-de-Gaulle-Str. 20"
    },
    "geo": {
      "latitude": 50.71601,
      "longitude": 7.129804
    }
  },
  "openingHours": [
    {
      "opens": "08:00:00",
      "closes": "17:00:00",
      "dayOfWeek": "https://schema.org/Monday"
    },
    {
      "opens": "08:00:00",
      "closes": "17:00:00",
      "dayOfWeek": "https://schema.org/Tuesday"
    },
    {
      "opens": "08:00:00",
      "closes": "17:00:00",
      "dayOfWeek": "https://schema.org/Wednesday"
    },
    {
      "opens": "08:00:00",
      "closes": "17:00:00",
      "dayOfWeek": "https://schema.org/Thursday"
    },
    {
      "opens": "08:00:00",
      "closes": "17:00:00",
      "dayOfWeek": "https://schema.org/Friday"
    },
    {
      "opens": "10:00:00",
      "closes": "12:00:00",
      "dayOfWeek": "https://schema.org/Saturday"
    }
  ],
  "closurePeriods": [],
  "serviceTypes": [
    "parcel:pick-up",
    "parcel:drop-off-unlabeled",
    "postident",
    "express:drop-off-easy",
    "parcel:drop-off-firstmile-unlabeled",
    "parcel:drop-off-firstmile",
    "express:drop-off",
    "parcel:drop-off-return-unlabeled",
    "parcel:drop-off-return",
    "express:drop-off-account",
    "cash-on-delivery",
    "express:drop-off-unlabeled",
    "express:drop-off-prelabeled",
    "parcel:drop-off",
    "parking",
    "age-verification",
    "express:pick-up",
    "letter-service"
  ],
  "averageCapacityDayOfWeek": []
}

{
  "status": 400,
  "title": "Unknown Service Type",
  "detail": "Provided serviceType xyz is not known."
}

{
  "status": 401,
  "title": "Unauthorized",
  "detail": "Invalid token"
}

{
  "status": 404,
  "title": "Location not found",
  "detail": "Location with provided keyword ID could not be found."
}

{
  "status": 500,
  "title": "Internal Server Error."
}

Service Homepage: developer.dhl.com/api-reference/location-finder-unified#reference-docs-section

dhllogisticslocationsshippingpudo