API Reference

Track & Trace

Track your booking updates and milestones with our Track & Trace API. Stay informed effortlessly with our tracking subscription service.

📘

Looking for more help ? Please try to ask our AI chatbot here

Effortlessly monitor the status and measure the carbon footprint of your Air Cargo shipments across a vast network of over 220+ airlines with the Track & Trace API.

For those who wish to remain seamlessly informed on important milestones such as departure, arrival, and customs clearance, without missing any updates, we offer a convenient Tracking Subscription endpoint. By subscribing, you'll receive tracking updates directly on your preferred channel, be it through a URL or via email. Additionally, you are able to unsubscribe from updates any time via our Tracking Unsubscription endpoint.

Track & Trace API Flow

Track & Trace API Flow

Tracking Subscription

This API endpoint is designed for subscribing to our Track & Trace updates. By providing a URL or email address, you'll seamlessly receive tracking updates directly from our system, eliminating the need to call our API.

Typically, updates are pushed on a regular basis, but the frequency may vary based on factors like the partner or the channel used. You can see the list of all possible tracking events and event codes here.

When making a Tracking Subscription request, you can specify an API URL (sent via POST) or emails addresses (up to five), or both. Please refer to the email template and objects description for further guidance about the update you will receive.

Please note: if you're using our Tracking Subscription by URL feature, it's important to know that we can't take responsibility for your callback URL and its functionality. Everything from the integration to making sure your URL is working properly falls on you and your development team. We're here to support you along the way, but just remember that this part is up to you!

Subscription Lifecycle

  • After a subscription is created, it remains active for 3 weeks.
  • If all milestone updates are not received within this period, the subscription will automatically deactivate.
  • Once deactivated, no further updates will be sent.

Renewing a Subscription

  • If all milestones are not received within the 3-week period, a new subscription must be created to continue receiving updates for another cycle.

Data Dependency

  • Receiving milestone updates is dependent on data availability from airlines.
  • If all required data is not received within the 3-week period due to airlines not providing the data, the subscription will still deactivate as scheduled.
  • To continue receiving updates, a new subscription must be created.

Predictive Milestones

Overview

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

  • FWB
  • RCS
  • MAN
  • DEP
  • ARR
  • RCF
  • NFD
  • DLV

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.

Tracking Unsubscription

With this API endpoint you can seamlessly stop receiving tracking updates directly from our system by providing the subscribed URL or email address, should you wish to discontinue the service.

Once unsubscribed, you'll no longer receive updates. However, you may resubscribe at any time to resume receiving updates.

Callback Authentication

With the increasing volume of data transmitted over the internet and API connections, data security is more crucial than ever. To strengthen protection, we have introduced an authentication process for our different callbacks.

You can request authentication using one of the following methods:

  • Basic Auth
  • Bearer Token
  • HMAC signature

📘

AWBs with data older than 1 year are hidden by default to prevent confusion with reused numbers. Contact us if you need historical records.