Skip to main content

Status Overview

Status Codes

CodeNameDescription
ORDEREDOrder CreatedInitial status when order is received
LABEL_GENERATEDLabel GeneratedShipping label has been created
MANIFEST_SUBMITTEDManifest SubmittedAdded to AWB manifest
PICKED_UPPicked UpCollected by carrier
CUSTOMS_CLEARANCECustoms ClearanceProcessing at export customs
IN_TRANSITIn TransitOn the way to destination
CUSTOMS_ARRIVEDArrived at DestinationArrived in destination country
CUSTOMS_PROCESSINGCustoms ProcessingImport customs processing
CUSTOMS_HOLDCustoms HoldHeld for additional documentation
CUSTOMS_RELEASEDCustoms ReleasedCleared customs
OUT_FOR_DELIVERYOut for DeliveryWith local delivery driver
DELIVERY_ATTEMPTEDDelivery AttemptedDelivery was attempted but failed
DELIVEREDDeliveredSuccessfully delivered
DELIVERY_FAILEDDelivery FailedCould not be delivered
RETURN_TO_SENDERReturn to SenderBeing returned to origin
RETURNEDReturnedReturned to sender
VOIDEDVoidedOrder cancelled
EXCEPTIONExceptionGeneral exception/issue

Status Details

ORDERED

{
  "status": "ORDERED",
  "statusName": "Order Created",
  "description": "Order has been received and is being processed"
}
Next statuses: LABEL_GENERATED, VOIDED

LABEL_GENERATED

{
  "status": "LABEL_GENERATED",
  "statusName": "Label Generated",
  "description": "Shipping label has been created and is ready for printing",
  "labelUrl": "https://..."
}
Next statuses: MANIFEST_SUBMITTED, VOIDED

MANIFEST_SUBMITTED

{
  "status": "MANIFEST_SUBMITTED",
  "statusName": "Manifest Submitted",
  "description": "Parcel has been added to AWB manifest",
  "awbNumber": "180-12345678"
}
Next statuses: PICKED_UP

IN_TRANSIT

{
  "status": "IN_TRANSIT",
  "statusName": "In Transit",
  "description": "Package is on the way to destination",
  "location": "Guayaquil, EC",
  "estimatedDelivery": "2024-12-28T18:00:00Z"
}
Next statuses: OUT_FOR_DELIVERY, CUSTOMS_HOLD, EXCEPTION

DELIVERED

{
  "status": "DELIVERED",
  "statusName": "Delivered",
  "description": "Package has been delivered successfully",
  "deliveredAt": "2024-12-27T14:30:00Z",
  "signature": "M. García",
  "deliveryLocation": "Front Door"
}
Terminal status - No further transitions

CUSTOMS_HOLD

{
  "status": "CUSTOMS_HOLD",
  "statusName": "Customs Hold",
  "description": "Package is held at customs pending documentation",
  "holdReason": "Additional documentation required",
  "requiredDocuments": ["Commercial Invoice", "ID Copy"]
}
Next statuses: CUSTOMS_RELEASED, RETURN_TO_SENDER

DELIVERY_FAILED

{
  "status": "DELIVERY_FAILED",
  "statusName": "Delivery Failed",
  "description": "Package could not be delivered",
  "failureReason": "Recipient not available",
  "attemptCount": 3
}
Next statuses: RETURN_TO_SENDER, OUT_FOR_DELIVERY (retry)

Status Groups

Pre-Shipment

  • ORDERED
  • LABEL_GENERATED
  • MANIFEST_SUBMITTED

In Transit

  • PICKED_UP
  • CUSTOMS_CLEARANCE
  • IN_TRANSIT
  • CUSTOMS_ARRIVED
  • CUSTOMS_PROCESSING
  • CUSTOMS_RELEASED

Delivery

  • OUT_FOR_DELIVERY
  • DELIVERY_ATTEMPTED
  • DELIVERED

Exceptions

  • CUSTOMS_HOLD
  • DELIVERY_FAILED
  • RETURN_TO_SENDER
  • RETURNED
  • EXCEPTION

Cancelled

  • VOIDED

Webhook Events by Status

StatusWebhook Event
LABEL_GENERATEDparcel.label_generated
MANIFEST_SUBMITTEDparcel.manifest_submitted
IN_TRANSITparcel.status_changed
OUT_FOR_DELIVERYparcel.out_for_delivery
DELIVEREDparcel.delivered
DELIVERY_FAILEDparcel.exception
CUSTOMS_HOLDparcel.exception
RETURN_TO_SENDERparcel.exception