Skip to content

Collection points (PUDO)

Overview

Some couriers support collection points (PUDO / parcel lockers / agent stores). When a booking uses a collection point, the booking response may include a collection_point object with agent id, provider, store name, address, surcharge, and flags.

Endpoints

Method	Path	Purpose
`POST`	`/api/collection-points/search`	Search collection points near an address or for a query
`POST`	`/api/collection-points/nearby-agents`	List nearby agents
`POST`	`/api/collection-points/closest`	Resolve the closest suitable point
`GET`	`/api/collection-points/supported-couriers`	Which courier string_ids support collection points

Authentication is required for these routes (API key / session as for other member APIs).

Booking response field

When set, get a booking may include:

{
  "collection_point": {
    "agent_id": "...",
    "provider": "...",
    "store_name": "...",
    "address": {},
    "surcharge": 0,
    "use_closest": false
  }
}