Air Tracking Event Updated

Developing

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": "b7c2f5a1-0e83-5d44-9a16-7f3c81de2b90",
      "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: 1f0b6a2e-7c41-4d9a-b3e8-2a5c9d7f10bb' \
--header 'X-Modaltrans-Event: air_tracking_events/update' \
--header 'User-Agent: Modaltrans-Webhook/1.0' \
--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": "b7c2f5a1-0e83-5d44-9a16-7f3c81de2b90",
      "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. Any other status, a timeout or a connection failure is retried after 1, 5 and 10 minutes.

This response does not have a body.

Modified at 2026-09-25 12:12:18

Air Tracking Event Created