Delivery Points
GET /delivery-points — rate limit 30 / min
Returns the pickup / delivery points (shops, lockers, post offices — PUDO) close to a postal code. With type the points come normalized and one of them can be chosen for a shipment with options.deliveryPoint; without type the raw BRT answer is relayed as it always was.
| Query parameter | Required | Description |
|---|---|---|
carrier | No | brt (default) or poste |
postalCode | Yes | |
city | For BRT | Required for BRT, ignored for Poste |
type | For Poste | Poste: puntoposte (Punto Poste shop), locker (Punto Poste Locker), ufficio (post office). BRT: fermopoint (shop), brtlocker (BRT Locker). For BRT it switches on the normalized list |
address | No | Street, to refine the raw BRT search |
The normalized search needs a contract of the carrier that delivers to that kind of point on your account, otherwise it answers 422.
Request
curl "https://<subdomain>.spedisci.online/api/2026-09/delivery-points?carrier=poste&type=puntoposte&postalCode=00144" \
-H "Authorization: Bearer <access_token>" \
-H "Accept: application/json"Delivery point object
| Field | Type | Description |
|---|---|---|
carrier | "poste" | "brt" | |
type | string | puntoposte, locker, ufficio, fermopoint, brtlocker |
code | string | The value to pass as options.deliveryPoint.code |
name, address, postalCode, city, province, phone | string|null | |
lat, lng | number|null | Coordinates |
hours | object|null | Poste: weekdays and saturday with open / close |
hoursText | string|null | BRT: opening hours on one line |
distance | integer|null | BRT: metres from the searched place |
saturation | integer|null | Poste: how full the point is, in percent |
Without type, data is the BRT answer passed through as received: its structure depends on the carrier and may change with it.
| HTTP | code | When |
|---|---|---|
422 | validation_failed | Missing postalCode, city for BRT or type for Poste; no contract on the account delivers to this kind of point |
502 | carrier_error | The delivery points service is not available |
Delivering to a point
Pass the chosen point in options.deliveryPoint of POST /shipments. Italy only.
"options": {
"deliveryPoint": { "type": "puntoposte", "code": "API25", "postalCode": "00144" }
}| Field | Required | Description |
|---|---|---|
type | Yes | Same values as the search |
code | Yes | code of the point |
postalCode | No | Postal code used in the search; default the recipient’s |
city | No | City used in the search (BRT); default the recipient’s |
- Poste (Poste Delivery Business Express / Standard contracts): cash on delivery and several parcels only with
ufficio; a locker takes one parcel within its size and weight limits; no round trip (Andata & Ritorno). The label carries the address of the point; name, phone and email stay the recipient’s. - BRT (direct BRT contracts, no cash on delivery): the label stays addressed to the recipient and BRT delivers to the point.
The shipment returns the point in deliveryPoint.
The recipient’s phone and email matter here: the carrier uses them to notify that the parcel is waiting at the point.