Air Tracking Event Updated

Webhook

POST

Sent when an air waybill status you already received changes. Only real changes are forwarded: the date, the status code or description, the airport, the flight number, or the estimated and actual flag.

Request

Header Params

Body Params application/json

Example

{
  "webhookId": 12,
  "eventName": "air_tracking_events/update",
  "deliveryId": "8d3f1c07-95ab-4e62-8f1d-6b0e4a2c33de",
  "sentAt": "2026-09-22T11:12:29Z",
  "data": [
    {
      "eventID": "391039b2-3831-5fb1-b105-0e7a5230b374",
      "eventType": "AIR_WAYBILL",
      "statusCode": "DEP",
      "statusDescription": "Departed",
      "eventClassifierCode": "ACT",
      "eventDateTime": "2026-09-21T17:00:00Z",
      "eventCreatedDateTime": "2026-09-22T11:12:29Z",
      "airWaybillNumber": "17204904981",
      "flight": {
        "flightNumber": "CV5270A",
        "airport": {
          "iataCode": "LUX",
          "name": "FINDEL AP"
        }
      },
      "modaltrans": {
        "systemStatus": "departed",
        "carrierEventDescription": "departed | 15 Pcs | 217 KILOGRAM",
        "carrierCode": "CV",
        "eventKey": "54321753-53a9-5ac3-9c12-1daab527d88f",
        "loadingReference": "SUPIM0050651"
      }
    }
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://your-api-server.com' \
--header 'X-Modaltrans-Signature: sha256=d55e674078099a696aebbcb1c4e0094a938fd7902667c8d06de366bcdfcc2741' \
--header 'X-Modaltrans-Delivery: 8d3f1c07-95ab-4e62-8f1d-6b0e4a2c33de' \
--header 'X-Modaltrans-Event: air_tracking_events/update' \
--header 'User-Agent: Modaltrans-Webhook/1.0' \
--header 'X-Api-Key: 3f9c1ab24e7d05b6c8fa1d3e9b470a52' \
--header 'Content-Type: application/json' \
--data '{
  "webhookId": 12,
  "eventName": "air_tracking_events/update",
  "deliveryId": "8d3f1c07-95ab-4e62-8f1d-6b0e4a2c33de",
  "sentAt": "2026-09-22T11:12:29Z",
  "data": [
    {
      "eventID": "391039b2-3831-5fb1-b105-0e7a5230b374",
      "eventType": "AIR_WAYBILL",
      "statusCode": "DEP",
      "statusDescription": "Departed",
      "eventClassifierCode": "ACT",
      "eventDateTime": "2026-09-21T17:00:00Z",
      "eventCreatedDateTime": "2026-09-22T11:12:29Z",
      "airWaybillNumber": "17204904981",
      "flight": {
        "flightNumber": "CV5270A",
        "airport": {
          "iataCode": "LUX",
          "name": "FINDEL AP"
        }
      },
      "modaltrans": {
        "systemStatus": "departed",
        "carrierEventDescription": "departed | 15 Pcs | 217 KILOGRAM",
        "carrierCode": "CV",
        "eventKey": "54321753-53a9-5ac3-9c12-1daab527d88f",
        "loadingReference": "SUPIM0050651"
      }
    }
  ]
}'

Responses

🟢204Accepted

Return any 2xx once you have stored the body. Process it afterwards. A 5xx, 408 or 429, a timeout (5 seconds to connect, 10 seconds for your answer) or a connection failure is retried up to five more times over 22 hours. Any other status, including redirects, is not retried. See the Webhooks page for the full schedule.

This response does not have a body.

Modified at 2026-11-09 10:33:49

Air Tracking Event Created

Customs Declaration Status Changed