Tracking
Leggi il tracking di una spedizione, cerca più lettere di vettura insieme o elenca il tracking recente. Vedi solo le tue spedizioni e quelle della tua rete.
Get tracking by waybill
In arrivo Il contratto è pubblicato prima dell'implementazione. Questa operazione non è ancora disponibile e la sua forma può ancora cambiare.
Tracking of a single waybill (LDV) number. Only shipments of the caller or of the caller's network are visible; anything else is 404 NOT_FOUND. Waybill numbers are guessable, so ownership is always checked.
Autenticazione: la tua chiave API nell'header X-API-Key.
Parametri
- Name
tracking_number- Type
- string
- obbligatorio
- Description
Waybill (LDV) number.
- Name
include_parcel_history- Type
- boolean
- Description
For multi-parcel shipments return the full history of every parcel instead of its current state.
Predefinito:
false.
Risposte
200Tracking of the shipment.Tracking401Missing, invalid or expired API key. Codes:API_KEY_MISSING,API_KEY_INVALID,API_KEY_EXPIRED.Error403Authenticated but not allowed. Codes:FEATURE_NOT_ENABLED(reserved feature not enabled for the customer),IP_NOT_ALLOWED(the key is restricted to other addresses),ACCOUNT_INACTIVE,CUSTOMER_OUT_OF_SCOPE.Error404The resource does not exist or is not visible to the caller. Codes:NOT_FOUNDand resource-specific ones (SHIPMENT_NOT_FOUND,QUOTATION_NOT_FOUND,CUSTOMER_NOT_FOUND, ...). Resources of other customers are reported as not found.Error410Version retired. CodeVERSION_RETIRED.Error429Daily or burst limit exceeded. CodeDAILY_LIMIT_EXCEEDEDorRATE_LIMIT_EXCEEDED. WaitRetry-Afterseconds.Error500Unexpected error. CodeSERVER_ERROR;details.correlation_idrepeats the correlation id.Error502The carrier or an internal dependency failed. CodeUPSTREAM_ERROR. Safe to retry reads; retry writes with the sameIdempotency-Key.Error
Richiesta
Caricamento...
Risposta 200
{
"tracking_number": "EX0000000001",
"status": {
"code": "IN_TRANSIT",
"description": "In transito"
},
"carrier": "SDA",
"shipment_id": "1234567",
"offer_code": "offer_example_0002",
"client_reference": "REF-0001",
"pickup_booking_code": "PK0000000002",
"tracking_events": [
{
"id": 1,
"timestamp": "2026-12-10T11:41:00+00:00",
"carrier_status_code": "RIT",
"description": "Collected",
"note": "The shipment was collected from the sender",
"location": "Example hub",
"signature": null
},
{
"id": 2,
"timestamp": "2026-12-10T15:10:02+00:00",
"carrier_status_code": "PPP",
"description": "Departed",
"note": "The shipment is in transit",
"location": "Example hub",
"signature": null
}
],
"carrier_tracking_url": "https://tracking.example.com/EX0000000001",
"created_at": "2026-12-09T09:35:12+00:00",
"last_update": "2026-12-10T15:10:02+00:00"
}Find tracking by waybill, reference or offer code
In arrivo Il contratto è pubblicato prima dell'implementazione. Questa operazione non è ancora disponibile e la sua forma può ancora cambiare.
Finds the tracking of one shipment by exactly one of tracking_number, client_reference or offer_code. Only shipments of the caller or of the caller's network are visible; anything else is 404 NOT_FOUND.
Autenticazione: la tua chiave API nell'header X-API-Key.
Parametri
- Name
tracking_number- Type
- string
- Description
Waybill (LDV) number.
- Name
client_reference- Type
- string
- Description
Your reference.
- Name
offer_code- Type
- string
- Description
Offer code.
- Name
include_parcel_history- Type
- boolean
- Description
For multi-parcel shipments return the full history of every parcel instead of its current state.
Predefinito:
false.
Risposte
200Tracking of the shipment.Tracking400Malformed or invalid request. Codes:VALIDATION_ERROR(withdetails.errors),INVALID_JSON,IDEMPOTENCY_KEY_REQUIRED,UNSUPPORTED_VERSION.Error401Missing, invalid or expired API key. Codes:API_KEY_MISSING,API_KEY_INVALID,API_KEY_EXPIRED.Error403Authenticated but not allowed. Codes:FEATURE_NOT_ENABLED(reserved feature not enabled for the customer),IP_NOT_ALLOWED(the key is restricted to other addresses),ACCOUNT_INACTIVE,CUSTOMER_OUT_OF_SCOPE.Error404The resource does not exist or is not visible to the caller. Codes:NOT_FOUNDand resource-specific ones (SHIPMENT_NOT_FOUND,QUOTATION_NOT_FOUND,CUSTOMER_NOT_FOUND, ...). Resources of other customers are reported as not found.Error410Version retired. CodeVERSION_RETIRED.Error429Daily or burst limit exceeded. CodeDAILY_LIMIT_EXCEEDEDorRATE_LIMIT_EXCEEDED. WaitRetry-Afterseconds.Error500Unexpected error. CodeSERVER_ERROR;details.correlation_idrepeats the correlation id.Error502The carrier or an internal dependency failed. CodeUPSTREAM_ERROR. Safe to retry reads; retry writes with the sameIdempotency-Key.Error
Richiesta
Caricamento...
Risposta 200
{
"tracking_number": "EX0000000001",
"status": {
"code": "IN_TRANSIT",
"description": "In transito"
},
"carrier": "SDA",
"shipment_id": "1234567",
"offer_code": "offer_example_0002",
"client_reference": "REF-0001",
"pickup_booking_code": "PK0000000002",
"tracking_events": [
{
"id": 1,
"timestamp": "2026-12-10T11:41:00+00:00",
"carrier_status_code": "RIT",
"description": "Collected",
"note": "The shipment was collected from the sender",
"location": "Example hub",
"signature": null
},
{
"id": 2,
"timestamp": "2026-12-10T15:10:02+00:00",
"carrier_status_code": "PPP",
"description": "Departed",
"note": "The shipment is in transit",
"location": "Example hub",
"signature": null
}
],
"carrier_tracking_url": "https://tracking.example.com/EX0000000001",
"created_at": "2026-12-09T09:35:12+00:00",
"last_update": "2026-12-10T15:10:02+00:00"
}Track several shipments
In arrivo Il contratto è pubblicato prima dell'implementazione. Questa operazione non è ancora disponibile e la sua forma può ancora cambiare.
Tracking of up to 50 waybills in one call. Only shipments of the caller or of the caller's network are visible: a waybill with no match, or that belongs to someone else, is returned with status NOT_FOUND and no events (the two cases are indistinguishable) instead of failing the call. Events are oldest first.
Autenticazione: la tua chiave API nell'header X-API-Key.
Parametri
- Name
tracking_numbers- Type
- array of string
- obbligatorio
- Description
Waybill numbers, comma-separated, up to 50.
items ≤ 50.
- Name
include_parcel_history- Type
- boolean
- Description
For multi-parcel shipments return the full history of every parcel instead of its current state.
Predefinito:
false.
Risposte
200One item per waybill, in request order.TrackingList400Malformed or invalid request. Codes:VALIDATION_ERROR(withdetails.errors),INVALID_JSON,IDEMPOTENCY_KEY_REQUIRED,UNSUPPORTED_VERSION.Error401Missing, invalid or expired API key. Codes:API_KEY_MISSING,API_KEY_INVALID,API_KEY_EXPIRED.Error403Authenticated but not allowed. Codes:FEATURE_NOT_ENABLED(reserved feature not enabled for the customer),IP_NOT_ALLOWED(the key is restricted to other addresses),ACCOUNT_INACTIVE,CUSTOMER_OUT_OF_SCOPE.Error410Version retired. CodeVERSION_RETIRED.Error429Daily or burst limit exceeded. CodeDAILY_LIMIT_EXCEEDEDorRATE_LIMIT_EXCEEDED. WaitRetry-Afterseconds.Error500Unexpected error. CodeSERVER_ERROR;details.correlation_idrepeats the correlation id.Error502The carrier or an internal dependency failed. CodeUPSTREAM_ERROR. Safe to retry reads; retry writes with the sameIdempotency-Key.Error
Richiesta
Caricamento...
Risposta 200
{
"data": [
{
"tracking_number": "EX0000000001",
"status": {
"code": "IN_TRANSIT",
"description": "In transito"
},
"carrier": "SDA",
"shipment_id": "1234567",
"offer_code": "offer_example_0002",
"client_reference": "REF-0001",
"pickup_booking_code": "PK0000000002",
"tracking_events": [
{
"id": 1,
"timestamp": "2026-12-10T11:41:00+00:00",
"carrier_status_code": "RIT",
"description": "Collected",
"note": "The shipment was collected from the sender",
"location": "Example hub",
"signature": null
},
{
"id": 2,
"timestamp": "2026-12-10T15:10:02+00:00",
"carrier_status_code": "PPP",
"description": "Departed",
"note": "The shipment is in transit",
"location": "Example hub",
"signature": null
}
],
"carrier_tracking_url": "https://tracking.example.com/EX0000000001",
"created_at": "2026-12-09T09:35:12+00:00",
"last_update": "2026-12-10T15:10:02+00:00"
}
],
"meta": {
"total": 1,
"page": 1,
"per_page": 50
}
}Get tracking of a shipment
In arrivo Il contratto è pubblicato prima dell'implementazione. Questa operazione non è ancora disponibile e la sua forma può ancora cambiare.
Tracking of a shipment you know by id. Only your own or your network's shipments; anything else is 404 NOT_FOUND.
Autenticazione: la tua chiave API nell'header X-API-Key.
Parametri
- Name
shipment_id- Type
- string
- obbligatorio
- Description
Shipment id.
- Name
include_parcel_history- Type
- boolean
- Description
For multi-parcel shipments return the full history of every parcel instead of its current state.
Predefinito:
false.
Risposte
200Tracking of the shipment.Tracking401Missing, invalid or expired API key. Codes:API_KEY_MISSING,API_KEY_INVALID,API_KEY_EXPIRED.Error403Authenticated but not allowed. Codes:FEATURE_NOT_ENABLED(reserved feature not enabled for the customer),IP_NOT_ALLOWED(the key is restricted to other addresses),ACCOUNT_INACTIVE,CUSTOMER_OUT_OF_SCOPE.Error404The resource does not exist or is not visible to the caller. Codes:NOT_FOUNDand resource-specific ones (SHIPMENT_NOT_FOUND,QUOTATION_NOT_FOUND,CUSTOMER_NOT_FOUND, ...). Resources of other customers are reported as not found.Error410Version retired. CodeVERSION_RETIRED.Error429Daily or burst limit exceeded. CodeDAILY_LIMIT_EXCEEDEDorRATE_LIMIT_EXCEEDED. WaitRetry-Afterseconds.Error500Unexpected error. CodeSERVER_ERROR;details.correlation_idrepeats the correlation id.Error502The carrier or an internal dependency failed. CodeUPSTREAM_ERROR. Safe to retry reads; retry writes with the sameIdempotency-Key.Error
Richiesta
Caricamento...
Risposta 200
{
"tracking_number": "EX0000000001",
"status": {
"code": "IN_TRANSIT",
"description": "In transito"
},
"carrier": "SDA",
"shipment_id": "1234567",
"offer_code": "offer_example_0002",
"client_reference": "REF-0001",
"pickup_booking_code": "PK0000000002",
"tracking_events": [
{
"id": 1,
"timestamp": "2026-12-10T11:41:00+00:00",
"carrier_status_code": "RIT",
"description": "Collected",
"note": "The shipment was collected from the sender",
"location": "Example hub",
"signature": null
},
{
"id": 2,
"timestamp": "2026-12-10T15:10:02+00:00",
"carrier_status_code": "PPP",
"description": "Departed",
"note": "The shipment is in transit",
"location": "Example hub",
"signature": null
}
],
"carrier_tracking_url": "https://tracking.example.com/EX0000000001",
"created_at": "2026-12-09T09:35:12+00:00",
"last_update": "2026-12-10T15:10:02+00:00"
}Modelli
Oggetti usati dalle richieste e dalle risposte di questa pagina.
ParceLabsVersion
CorrelationId
KeyLocale
Tracking
Only shipments of the caller or of the caller's network are visible.
- Name
tracking_number- Type
- string
- obbligatorio
- Alias italiano:
lettera_vettura - Description
Waybill (LDV) number.
- Name
status- Type
- TrackingStatus
- obbligatorio
- Alias italiano:
status - Description
Current status.
- Name
carrier- Type
- string · nullable
- Alias italiano:
vettore - Description
Carrier family code.
- Name
shipment_id- Type
- string · nullable
- Alias italiano:
id_ordine - Description
Shipment identifier, when known.
- Name
offer_code- Type
- string · nullable
- Alias italiano:
codice_offerta - Description
Offer code.
- Name
client_reference- Type
- string · nullable
- Alias italiano:
custom - Description
Your reference.
- Name
pickup_booking_code- Type
- string · nullable
- Alias italiano:
codice_prenotazione - Description
Pickup booking code.
- Name
tracking_events- Type
- array of TrackingEvent
- obbligatorio
- Alias italiano:
dettagli - Description
Events, oldest first.
- Name
parcels- Type
- array of TrackingParcel
- Alias italiano:
parcels - Description
Per-parcel status for multi-parcel shipments.
- Name
carrier_tracking_url- Type
- string (uri) · nullable
- Alias italiano:
url_tracking - Description
Carrier public tracking page.
- Name
created_at- Type
- string (date-time)
- Alias italiano:
creato_il - Description
When the shipment was created.
- Name
last_update- Type
- string (date-time)
- Alias italiano:
ultimo_aggiornamento - Description
Last tracking update.
TrackingStatus
- Name
code- Type
- string
- obbligatorio
- Alias italiano:
codice - Description
Normalised status.
Valori ammessi:
PENDING,IN_TRANSIT,OUT_FOR_DELIVERY,DELIVERED,EXCEPTION,RETURNED,HELD,NOT_FOUND.
- Name
description- Type
- string
- obbligatorio
- Alias italiano:
descrizione - Description
Human-readable description.
TrackingEvent
- Name
id- Type
- integer
- obbligatorio
- Alias italiano:
id - Description
Progressive event id.
- Name
timestamp- Type
- string (date-time)
- obbligatorio
- Alias italiano:
data - Description
When it happened (carrier local time converted to UTC).
- Name
carrier_status_code- Type
- string
- Alias italiano:
status - Description
Carrier event code (for example
PPP,THE,000). See the status-codes reference page.
- Name
description- Type
- string
- obbligatorio
- Alias italiano:
descrizione - Description
Event description.
- Name
note- Type
- string · nullable
- Alias italiano:
note - Description
Carrier note.
- Name
location- Type
- string · nullable
- Alias italiano:
filiale - Description
Branch or hub.
- Name
signature- Type
- string · nullable
- Alias italiano:
firma - Description
Name of who signed for the delivery.
TrackingParcel
- Name
id- Type
- string
- obbligatorio
- Alias italiano:
id - Description
Parcel identifier (sticker).
- Name
status- Type
- TrackingStatus
- obbligatorio
- Alias italiano:
stato - Description
Current status of the parcel.
- Name
carrier_status_code- Type
- string
- Alias italiano:
codice_stato_vettore - Description
Carrier code of the current state.
- Name
updated_at- Type
- string (date-time)
- Alias italiano:
date - Description
Last update.
- Name
history- Type
- array of object
- Alias italiano:
storico - Description
Complete history. Only with
include_parcel_history=true.
Unauthorized
Forbidden
NotFound
Gone
TooManyRequests
ServerError
BadGateway
BadRequest
TrackingList
PageMeta
Pagination metadata.
- Name
total- Type
- integer
- obbligatorio
- Description
Total number of items matching the filters.
- Name
page- Type
- integer
- obbligatorio
- Description
Current page, starting at 1.
- Name
per_page- Type
- integer
- obbligatorio
- Description
Items per page.