Parcel Shops

Search for DPD pickup points (parcel shops, lockers, service points) by address or GPS coordinates.

Base Path: /api/v1/parcel-shop Auth: Bearer JWT token required

---

Endpoints summary

Method	Endpoint	Description
GET	/api/v1/parcel-shop/{parcelShopId}	Get a specific parcel shop by ID
POST	/api/v1/parcel-shop/address	Search parcel shops by address
POST	/api/v1/parcel-shop/coordinates	Search parcel shops by GPS coordinates

---

GET /api/v1/parcel-shop/{parcelShopId}

Retrieve details for a specific parcel shop.

Path parameter: parcelShopId — e.g., 699CH190001

Query parameter: locale (optional) — e.g., de_CH

curl -X GET "https://label-print-shipments.dpd.ch/api/v1/parcel-shop/699CH190001?locale=de_CH" \
  -H "Authorization: Bearer <jwt_token>"

Response 200 OK:

{
  "id": "699CH190001",
  "parcelShopId": 190001,
  "name": "DPD Pickup Point Zürich HB",
  "distance": 250,
  "type": 1,
  "address": {
    "name": "Kiosk Hauptbahnhof",
    "street": "Bahnhofplatz",
    "houseNumber": "1",
    "zipCode": "8000",
    "city": "Zürich",
    "countryCode": "CH"
  },
  "available": "Y",
  "latitude": 47.3769,
  "longitude": 8.5417,
  "openingHours": [
    {
      "weekDay": "MONDAY",
      "openMorning": "06:00",
      "closeMorning": "22:00",
      "openAfternoon": null,
      "closeAfternoon": null
    }
  ],
  "holidays": [
    { "start": "2025-12-24", "end": "2025-12-26" }
  ],
  "services": [
    { "code": "PICKUP", "available": true, "description": "Parcel pickup available" },
    { "code": "DROPOFF", "available": true, "description": "Parcel drop-off available" }
  ]
}

Status codes: 200 OK | 401 Unauthorized | 404 Not Found

---

POST /api/v1/parcel-shop/address

Search for parcel shops near an address. Results sorted by distance (closest first).

Request body:

Field	Type	Required	Description	Default
country	String (2)	Mandatory	ISO country code	—
zipCode	String	Mandatory	Postal code	—
city	String	Optional	City name	—
street	String	Optional	Street name	—
destCountryCode	String	Optional	Destination country for service filtering	—
weight	String	Optional	Parcel weight in kg	—
services	String	Optional	Comma-separated service codes	—
type	String	Optional	Parcel shop type filter	—
limit	Integer	Optional	Max results	25
availabilityDate	String	Optional	Check availability on date (yyyy-MM-dd)	—
hideClosed	Boolean	Optional	Exclude currently closed shops	false

curl -X POST "https://label-print-shipments.dpd.ch/api/v1/parcel-shop/address?locale=de_CH" \
  -H "Authorization: Bearer <jwt_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "CH",
    "zipCode": "8000",
    "city": "Zürich",
    "limit": 10
  }'

Status codes: 200 OK (may return empty list) | 400 Bad Request | 401 Unauthorized

---

POST /api/v1/parcel-shop/coordinates

Search for parcel shops near GPS coordinates. Same filtering and response format as address search.

Request body:

Field	Type	Required	Description
latitude	Double	Mandatory	GPS latitude (−90 to 90)
longitude	Double	Mandatory	GPS longitude (−180 to 180)
destCountryCode	String	Optional	Destination country
limit	Integer	Optional	Max results (default: 25)
hideClosed	Boolean	Optional	Exclude closed shops (default: false)
availabilityDate	String	Optional	Check availability on date

curl -X POST "https://label-print-shipments.dpd.ch/api/v1/parcel-shop/coordinates" \
  -H "Authorization: Bearer <jwt_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": 47.3769,
    "longitude": 8.5417,
    "limit": 10,
    "hideClosed": true
  }'

Status codes: 200 OK | 400 Bad Request | 401 Unauthorized

---

Parcel shop types

Type	Description
1	DPD Pickup Point
2	DPD Locker
3	Partner Shop (e.g., Post Office)
4	Service Point

---

Code examples

Parcel shop selector in a shipment form:

async function searchParcelShops(zipCode, city) {
  const response = await fetch(
    'https://label-print-shipments.dpd.ch/api/v1/parcel-shop/address',
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ country: 'CH', zipCode, city, limit: 10 })
    }
  );
  return response.json();
}

Map-based finder:

function findNearby(lat, lng) {
  return fetch('https://label-print-shipments.dpd.ch/api/v1/parcel-shop/coordinates', {
    method: 'POST',
    headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({ latitude: lat, longitude: lng, limit: 20, hideClosed: true })
  }).then(r => r.json());
}