Skip to main content

🚥 Status

Along with the event's status, which is the raw event's text provided by the courier, Ship24 is automatically detecting the meaning of this status and provides a normalized and codified version of it.

This information is available using 3 fields, depending on the degree of detail you require:

  • The statusCode which provides the codified meaning of a specific event.
  • The statusCategory which provides the codified category of a specific event.
  • The statusMilestone which provides the overall status of the shipment at the time of the event.

for example,

{
"eventId": "67a64a66-c0cd-429c-a00b-4a30499fd997",
"status": "ENTREGADO. Su envío está entregado.",
"occurrenceDatetime": "2023-01-09T15:11:00",
...
"statusCode": "delivery_delivered", // -> Meaning of this specific event (delivered)
"statusCategory": "delivery", // -> Category of this specific event (during "delivery" phase)
"statusMilestone": "delivered" // -> Overall status of the shipment at this time (delivered)
}
info

While the statusCategory and statusCode may be empty on non-significant events, the statusMilestone will be provided on each and every events of a shipment. If you need a high-level status of your shipment, statusMilestone is a great choice.

statusMilestone​

The statusMilestone provides an overall status of the shipment at any point in time. The field statusMilestone is provided both at event-level (overall status of the shipment during the occurrence of the event) and at shipment-level (overall status of the shipment at the present time).

statusMilestoneLabelDescriptionSample tracking number for testing
pendingPendingThe shipment doesn’t have events available yet or can’t be found.SHIP24TEST2023H1M00
info_receivedInfo. ReceivedThe shipment has been declared electronically and/or is in preparation by the shipper.SHIP24TEST2023H1M10
in_transitIn TransitThe shipment has been accepted or picked up from the shipper and is on the way.SHIP24TEST2023H1M20
out_for_deliveryOut for DeliveryThe shipment is about to be delivered, usually the same day.SHIP24TEST2023H1M30
failed_attemptFailed AttemptA delivery attempt was made and failed (Recipient not available, business closed, etc.)SHIP24TEST2023H1M40
available_for_pickupTo Pick UpThe shipment is ready to be picked up by the receiver. (At a pickup point such as a post office, a locker, or a local business)SHIP24TEST2023H1M50
deliveredDeliveredThe shipment has been delivered. (Delivered at home, picked-up from a pickup point, etc.)SHIP24TEST2023H1M60
exceptionExceptionThe shipment can’t be delivered due to issues that seems to be final (Returning, returned, lost, destroyed, etc.)SHIP24TEST2023H1M70
tip

The tracking numbers provided in Sample tracking number for testing are dummy tracking numbers that allows you to test your application on specific milestones code.

statusCode and statusCategory​

The statusCode and statusCategory provides the codified meaning of a specific event. If the event is not significant, it may not be provided.

statusCategorystatusCodeDescription
dataEvent related to data exchange, without physical meaning.
data_order_createdDelivery order created. The delivery order is electronically declared in the courier's system.
data_order_cancelledDelivery order cancelled. the delivery order has been cancelled in the courier's system.
data_delivery_proposedFinal delivery methods and/or time slots have been proposed to the receiver and the courier is waiting for his feedback.
data_delivery_decidedFinal delivery methods and/or time slots has been decided (by courier, sender, receiver or unknown).
transitEvent related to overall transit.
destinationEvent related to the arrival at the destination country.
destination_arrivalShipment arrived in the destination country.
customsEvent related to the customs clearance.
customs_receivedShipment received by/Presented to the customs.
customs_exceptionException or delay during customs clearance. Additional documents/payment may be required.
customs_rejectedShipment rejected by the customs.
customs_clearedShipment cleared by the customs.
deliveryEvent related to the delivery phase.
delivery_available_for_pickupShipment available for pickup at a pick-up point or at the Post Office.
delivery_out_for_deliveryShipment delivery in progress.
delivery_attemptedDelivery attempted and unsuccessful. Usually, the delivery will be tried again the next day or the shipment will be left at a pick-up point.
delivery_exceptionIssue during delivery or preventing the delivery.
delivery_deliveredShipment has been delivered.
exceptionEvent related to an exception/issue.
exception_returnShipment undeliverable, will be or being returned.
info

If you are looking for more specific statusCode or notice any detection issue on the parcels you are tracking, don't hesitate to contact us!