# Dpdgroup — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Find nearby DPD parcel shops and access detailed location information, station details, and network statistics across the DPD partner network. Search for parcel shop availability by country and get comprehensive insights into DPD's distribution infrastructure.

**Category:** Maps & Geospatial | **Website:** [dpdgroup.com/](https://dpdgroup.com/) | **Docs:** [parse.bot/marketplace/68645d4f-7169-4e38-b7f1-ea8134df5276/dpdgroup-com-api](https://parse.bot/marketplace/68645d4f-7169-4e38-b7f1-ea8134df5276/dpdgroup-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/dpdgroup/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get country partners

Returns the complete list of DPD partner brands and their country-specific website URLs, organized by region (Africa, Americas, Asia, Europe). Each partner entry includes brand name, region, and clickable URL. The list is deduplicated by URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/dpdgroup/get-country-partners \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get parcel shop details

Retrieves detailed information including opening hours and services for a specific parcel shop. Requires the same query used in search_parcel_shops and the shop_index from that search's results. Makes an ASP.NET AJAX postback to load the detail panel.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Same search query used in search_parcel_shops (postcode or city) |
| `shop_index` | string | Yes | Two-digit shop index from search_parcel_shops results (e.g. '00', '01', '02') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/dpdgroup/get-parcel-shop-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","shop_index":"<string>"}'
```

### Get parcelshop network stats

Returns high-level statistics about the DPD Pickup parcel shop network coverage across Europe, including number of countries, total pickup points in Europe, and pickup points in Germany.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/dpdgroup/get-parcelshop-network-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search parcel shops

Search for nearby DPD Pickup parcel shops and stations by postcode or city. Returns up to 10 shops with name, address, distance, coordinates, and type (parcelshop or station). Results are ordered by distance from the search location.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filter_type` | string | No | Filter results by type. Accepted values: 'parcelshop', 'station'. Omitting returns all types. |
| `query` | string | Yes | Postcode or city name to search near (e.g. '10115' for Berlin, '80331' for Munich) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/dpdgroup/search-parcel-shops \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"filter_type":"<string>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.