Predictive Milestones

The Tracking API provides AI-generated predictive timestamps for key airfreight milestones.
These predictions help users anticipate shipment progression from FWB through DLV, even before the actual events occur.

Predictions are generated as soon as tracking begins and continuously refined as more data becomes available.

Supported Predicted Milestones

How Predictive Milestones Work

Predictive milestones are returned using the existing event object in the Tracking API.
When an event is predicted rather than actually recorded, additional prediction-related fields are included.
As new events occur, predictions may be updated.

This approach ensures full backward compatibility with existing Tracking API integrations.

Fields for Predictive Milestones

Each predicted milestone is returned through our actual event object with the additional following fields:

{  
	<...>
  "predictedEventDate": "2025-10-20T11:33:31+00:00",  
  "predictedEventDateP90": "2025-10-20T12:33:31+00:00",  
  "isPredicted": true,  
}

Prediction Confidence (P50 vs P90)

P50 represents the median expected time and is suitable for standard ETA calculations.
P90 represents a conservative estimate designed to reduce under-promising. It includes a buffer derived from the model’s historical uncertainty for the specific airline, route and shipment type.

Key Capabilities

Predicts full shipment lifecycle from FWB → DLV.
Provides both P50 (most likely) and P90 (high-confidence) arrival estimates.
Automatically selects the appropriate origin or destination for each milestone.
Integrated seamlessly into the existing Tracking API response structure.
Allows earlier detection of delays, no-shows, and irregular operations.

Predictive milestones are estimates, not contractual commitments.

Tracking Alerts

The Alerts module delivers early warning signals on shipment execution, enabling proactive issue management.

The Alerts module supports three levels:

OK: Shipment is progressing as expected. No action required.
WATCH: Potential risk detected. The shipment requires attention and monitoring.
AT_RISK: High likelihood of disruption. Immediate action may be required.

The alerts field is located at the root level of the tracking update:

{  
	<...>
  "alerts": {
    "level": "WATCH",
    "message": "FWB running late; risk to departure. Departure window in progress (15:04)."
  }
}

{  
	<...>
  "alerts": {
    "level": "OK",
    "message": ""
  }
}

By combining Predictive Milestones with Alerts, the Track & Trace API forecasts expected shipment events while highlighting when shipments are at risk, helping customers anticipate issues earlier and act faster.