Tracking
Per numero di spedizione – GET /shipments/{ldv}/tracking
curl https://demo.spedisci.online/api/2026-09/shipments/3UW0WTQ069239/tracking \
-H "Authorization: Bearer <access_token>"{
"trackingNumber": "3UW0WTQ069239",
"reference": "ORD-1234",
"carrier": { "code": "poste", "name": "Poste Delivery Business" },
"status": { "code": 3, "key": "in_transit", "label": "In transito" },
"events": [
{ "timestamp": "2026-10-01T08:12:00+02:00", "description": "In transito", "location": "Roma" },
{ "timestamp": "2026-09-30T10:26:00+02:00", "description": "Spedizione generata. In attesa di ritiro.", "location": "Telese Terme" }
],
"deliveredAt": null,
"trackingUpdatedAt": "2026-10-01T08:15:02+02:00"
}Gli eventi sono ordinati dal più recente; l’ultimo dell’elenco è sempre la
generazione della spedizione. I possibili valori di status sono elencati in
Formato delle risposte.
Per BDA – GET /tracking/bda/{bda}
Restituisce lo stesso formato cercando la spedizione per BDA, tra quelle degli ultimi 60 giorni.
Limiti ed errori
| Risposta | Significato |
|---|---|
404 not_found | Spedizione inesistente o di un altro cliente |
429 rate_limited | Troppe interrogazioni |
502 carrier_error | Il corriere non risponde |
Non interrogare il tracking a intervalli regolari per ogni spedizione:
registra un webhook sull’evento tracking.update e ricevi
l’aggiornamento appena lo stato cambia.
Last updated on