Notification | NoticeFlightChange

This webhook notifies the customer when a schedule change occurs. The customer must provide a callback URL to receive the notification.

Notice:
Product Scope: FareMarket

POST

Callback URL provided by the customer.

Parameter

Field Mandatory Type Scope Description
action required String NoticeFlightChange
timestamp required Int The ‘timestamp’ field should be a 10-digit Unix timestamp in seconds, used for encryption and data verification.
version optional String API version information, e.g. 3.2.0
request required Object
  orderNum required String AeroHub Order number generated by Commit. Unique ID for bookings for TechHub and FareMarket
  changeType required Int Type of flight change: 1 Flight Cancellation, 2 Flight Change (including delay)
  segments required Object[] flight information
    originalSegments required Object[] Original flight information
      flightNumber optional String Flight number, e.g. CA123. if flight number begin with 0, must waived all the zeros, e.g. CZ006 should be used as CZ6
      depAirport optional String Departure airport IATA 3-Letter Codes
      depTime optional String Departure date and time, format: YYYYMMDDHHMM e.g. 201203100315 means 2012/03/10 03:15
      arrAirport optional String Arrival airport IATA 3-Letter Codes
      arrTime optional String Arrival date and time, format: YYYYMMDDHHMM e.g. 201203101305 means 2012/03/10 13:05
    updatedSegments optional Object[] Post-change flight information
      flightNumber optional String Flight number, e.g. CA123. if flight number begin with 0, must waived all the zeros, e.g. CZ006 should be used as CZ6
      depAirport optional String Departure airport IATA 3-Letter Codes
      depTime optional String Departure date and time, format: YYYYMMDDHHMM e.g. 201203100315 means 2012/03/10 03:15
      arrAirport optional String Arrival airport IATA 3-Letter Codes
      arrTime optional String Arrival date and time, format: YYYYMMDDHHMM e.g. 201203101305 means 2012/03/10 13:05

Request_Example:

{  
  "action": "NoticeFlightChange",
  "timestamp": 1633046400,
  "version": "3.2.0",
  "request": {
    "orderNum": "AH12345678",
    "changeType": 2,
    "segments": [
      {
        "originalSegments": [
          {
            "flightNumber": "CA123",
            "depAirport": "PEK",
            "depTime": "202110010800",
            "arrAirport": "LAX",
            "arrTime": "202110011500"
          }
        ],
        "updatedSegments": [
          {
            "flightNumber": "CA124",
            "depAirport": "PEK",
            "depTime": "202110020900",
            "arrAirport": "LAX",
            "arrTime": "202110021600"
          }
        ]
      }
    ]
  }
}

Response

Field Type Description
status Int 0 for success, others for failure, refer to status error appendix for details
msg String Return message, maximum 64 char
orderNum String AeroHub Order number generated by Commit. Unique ID for bookings for TechHub and FareMarket

Success-Response:

{
    "status": 0,
    "msg": "",
    "orderNum": "AH12345678"
}

Status Code

Error-Response

{
    "status": 1000,
    "msg": "error message",
    "orderNum": "AH12345678"
}
Author：AeroHub  Create time：2024-07-26 16:09
Last editor：AeroHub  Update time：2026-03-19 18:06