ScheduleChange

  • Purpose: This interface is used to receive notifications of flight changes from suppliers, including flight delays, cancellations, and modifications.
  • Request Method: POST
  • Interface Encryption: No
  • FareMarket Address: /supplier/v1/api/schedule_change

Request Parameters

Parameter Name Type Required Description
apiKey string ✅ Each supplier has its own unique apiKey, used to represent the supplier’s identity, provided by AeroHub to the supplier before interface testing
requestId string ✅ Request ID, unique for each call in the ticketing process, 32 characters in length
purchaseOrderNo string ✅ AeroHub’s order number
ticketNo string ⬜️ Ticket number; for low-cost airlines, it can be consistent with the PNRCode
changedTime string ✅ Time when the flight change occurred; if unknown, the time of the interface call can be passed, using ISO 8601 format
changeType int ✅ Type of flight change: 1 Flight Cancellation, 2 Flight Change (including delay)
isChange bool ✅ Whether the type of itinerary has changed (e.g., direct flight to connecting flight, connecting flight to direct flight): true for changed, false for unchanged
items array/items Element ✅ Information about the flight change

array/items Element

Parameter Name Type Required Description
segmentNo int ✅ Sequence of the segment: 1 for outbound, 2 for return.
originalSegments array/originalSegments Element ✅ Itinerary information
changedSegments array/changedSegments Element ⬜️ Itinerary information; Note: Only necessary to return during flight changes

array/originalSegments Element

Parameter Name Type Required Description
flightNumber string ✅ Flight number, e.g., CA123.
depAirport string ✅ Departure airport code, using IATA three-letter code as the standard.
depTime string ✅ Departure date and time (local time).
arrAirport string ✅ Arrival airport code, using IATA three-letter code as the standard.
arrTime string ✅ Arrival date and time (local time).

array/changedSegments Element

Parameter Name Type Required Description
flightNumber string ✅ Flight number, e.g., CA123.
depAirport string ✅ Departure airport code, using IATA three-letter code as the standard.
depTime string ✅ Departure date and time (local time).
arrAirport string ✅ Arrival airport code, using IATA three-letter code as the standard.
arrTime string ✅ Arrival date and time (local time).

Sample Request:

{
    "apiKey": "PcrNq8964iFUkE0CyVV4bhgXXX",
    "requestId": "7a0091e344cc4a9886eafd4334d36bcb",
    "purchaseOrderNo": "F1783888564216623104",
    "ticketNo": "3DFCH0",
    "changedTime": "2024-05-07T15:28:28",
    "changeType": 2,
    "isChange": false,
    "items": [{
        "segmentNo": 1,
        "originalSegments": [{
            "flightNumber": "DD323",
            "depAirport": "UBP",
            "depTime": "2024-05-09T11:20",
            "arrAirport": "DMK",
            "arrTime": "2024-05-09T12:20"
            },
            {
            "flightNumber": "DD323",
            "depAirport": "UBP",
            "depTime": "2024-05-09T11:20",
            "arrAirport": "DMK",
            "arrTime": "2024-05-09T12:20"
            }],
        "changedSegments": [{
            "flightNumber": "DD323",
            "depAirport": "UBP",
            "depTime": "2024-05-09T11:30",
            "arrAirport": "DMK",
            "arrTime": "2024-05-09T12:30"
            }]
        }]
}

Response

Parameter Name Type Required Description
code int ✅ AeroHub’s status code, referring to Market Errors in the common instructions.
msg string ✅ AeroHub’s error description, referring to Market Errors in the common instructions.

Success-Response:

{
    "code": 200,
    "msg": "Successful"
}

Error-Response

{
    "code": 400,
    "msg": "Failed"
}

Notes

  • Ensure correct booking numbers and flight information are provided.
  • Times should be in ISO 8601 format.
  • The sequence starts from 1 for both outbound and return trips in case of round-trip.
  • changedSegments should only be returned in case of flight changes.
Author：AeroHub  Create time：2024-03-15 09:56
Last editor：AeroHub  Update time：2025-07-29 17:21