Ensuring that Carriyo maintains the most up-to-date shipment status is of paramount importance, benefiting both the merchant and their end customers.
Carriyo uses the batch tracking endpoint to retrieve the full history of status events for the specified shipments. The endpoint serves as a fallback for real-time status updates, particularly for shipments suspected of falling out of sync with the carrier's data.
To maximise efficiency, Carriyo will pass a list of tracking numbers to track multiple shipments (up to 20) in a single API call.
OK
Error
{- "tracking_numbers": [
- "string"
]
}{- "tracking_info": [
- {
- "tracking_number": "new-shipment-1",
- "status_events": [
- {
- "carriyo_status_code": "failed_delivery_attempt",
- "carriyo_reason_code": "refused_by_customer",
- "carrier_status_code": "CUSTOMER-REFUSAL",
- "carrier_status_description": "Customer refused to accept delivery",
- "status_update_date": "2023-05-24T14:15:05.222Z"
}
]
}
]
}