Change | GetChangeDetail

Retrieves the comprehensive details and real-time status of a specific change request. This endpoint serves as the “source of truth” for verifying fare differences and seat availability before final commitment.

Notice:
Product Scope: FareMarket and TechHub
Validation Role ：It is highly recommended to call this endpoint immediately before ConfirmChange to ensure the quote has not lapsed and the total amount remains accurate.

POST

/flight/change

Parameter

Field Mandatory Type Scope Description
action required String GetChangeDetail
key required String API security key applied from AeroHub.
signature required String Refer to the Guidelines for generation.
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
  changeNum required String change order number generated by API “SubmitChange”.

Request_Example:

{
    "action": "GetChangeDetail",
      "key": "n93mPT7WzN6cLKC5",
      "signature": "YhQ2EoBQOfOnf/EOnuuuK5i+K+ncydeQhjFpoxYiEMo=",
      "timestamp": 1685116518,
    "request": {
        "changeNum": "C20260310172445447"
    }
}

Response

Field Type Description
status Int 0: Succeeded
Others: Failed
Refer to “Status Code” below for details.
msg String Return message, maximum 64 characters.
changeNum String change order number generated by API “SubmitChange”.
changeType String Type of change:
VOLUNTARY: voluntary change
INVOLUNTARY: involuntary change
INFORMATION_UPDATER: information update
OTHER: other reasons
Refer to appendix ‘Change Type List’ for details
changeReason String Resason for change:
FLIGHT_CHANGE: flight change
FLIGHT_CANCEL: flight cancel
OTHER: other reasons
Refer to appendix ‘Change Reason List’ for details
customerRemark String Customer remarks
changeStatus String change order status. Refer to appendix ‘Change Status List’ for details
rejectReason String Rejection reason.
totalChangeFee Float Airline total change fee amount, Does not include any change service fee charged by AeroHub.
serviceCharge Float change service fee charged by AeroHub.
quotes Object[] Quotation details.
  ageType Int Passenger type:
0: adult
1: child
2: infant
  changeFee Float Airline change fee per passenger
  cabinFee Float Airline cabin difference per person.
passengers Object[] Passenger information for change.
  originalPassengers Object Original passenger information.
    firstName String Passenger first name. If there is a middle name, connect it with a space like “firstname middlename”.
    lastName String Passenger last name.
    ageType Int Passenger type:
0: adult
1: child
2: infant
    birthday String Passenger birthday, formatted with “YYYYMMDD”.
    gender String Passenger gender:
M: male
F: female
    nationality String Passenger nationality, 2-letter country code.
    cardNum String Passenger identity number, maximum 15 characters.
    cardExpired String The expiration date of the identity card, formatted with “YYYYMMDD”.
  updatedPassengers Object Updated passenger information.
    firstName String Passenger first name. If there is a middle name, connect it with a space like “firstname middlename”.
    lastName String Passenger last name.
    ageType Int Passenger type:
0: adult
1: child
2: infant
    birthday String Passenger birthday, formatted with “YYYYMMDD”.
    gender String Passenger gender:
M: male
F: female
    nationality String Passenger nationality, 2-letter country code.
    cardNum String Passenger identity number, maximum 15 characters.
    cardExpired String The expiration date of the identity card, formatted with “YYYYMMDD”.
segments Object[] Itinerary Information for change.
  originalSegments Object[] Original itinerary information.
    tripType Int Trip type:
1: outbound
2: inbound
    segmentNumber Int Segment number, starts from 1.
    flightNumber String Flight number, e.g. CA123.
    depAirport String Departure airport, IATA 3-letter code.
    arrAirport String Arrival airport, IATA 3-letter code.
    depTime String Departure date and time, formatted with “YYYYMMDDHHMM”.(e.g. 201203100315 represents 2012/03/10 03:15)
    arrTime String Arrival date and time, formatted with “YYYYMMDDHHMM”.（e.g. 201203101305 represents 2012/03/10 13:05)
  updatedSegments Object[] Updated itinerary information.
    tripType Int Trip type:
1: outbound
2: inbound
    segmentNumber Int Segment number, starts from 1.
    flightNumber String Flight number, e.g. CA123.
    depAirport String Departure airport, IATA 3-letter code.
    arrAirport String Arrival airport, IATA 3-letter code.
    departureDate String Departure date, formatted with “YYYYMMDD”.
    depTime String Departure date and time, formatted with “YYYYMMDDHHMM”.(e.g. 201203100315 represents 2012/03/10 03:15)
    arrTime String Arrival date and time, formatted with “YYYYMMDDHHMM”.(e.g. 201203101305 represents 2012/03/10 13:05)
tickets Object[] Ticket number list. It will have return data only when the “ChangeStatus” is “COMPLETED”, and only the updated ticket information will be returned.
  firstName String Passenger first name. If there is a middle name, connect it with a space like “firstname middlename”.
  lastName String Passenger last name.
  tripType Int Trip type:
1: outbound
2: inbound
  segmentNumber Int Segment number.
  flightNumber String Flight number.
  ticketNumber String Ticket number returns from airline.
  pnr String PNR returns from airline.

Success-Response:

{
  "status": 0,
  "msg": "Rescheduling succeeded",
  "changeNum": "C20241018101144760",
  "changeType": "VOLUNTARY",
  "changeReason": "OTHER",
  "customerRemark": "Please process the change as soon as possible.",
  "changeStatus": "CHANGED",
  "attachmentStatus": 1,
  "rejectReason": "",
  "totalChangeFee": 150.0,
  "serviceCharge": 20.0,
  "quotes": [
    {
      "ageType": 0,
      "passengerNum": 2,
      "changeFee": 100.0,
      "cabinFee": 50.0
    }
  ],
  "passengers": [
    {
      "originalPassengers": {
        "firstName": "John",
        "lastName": "Doe",
        "ageType": 0,
        "birthday": "19800101"
      },
      "updatedPassengers": {
        "firstName": "John",
        "lastName": "Doe",
        "ageType": 0,
        "birthday": "19800101",
        "gender": "M",
        "nationality": "US",
        "cardNum": "123456789012345",
        "cardExpired": "20301231"
      }
    },
    {
      "originalPassengers": {
        "firstName": "Jane",
        "lastName": "Smith",
        "ageType": 1,
        "birthday": "20100615"
      },
      "updatedPassengers": {
        "firstName": "Jane",
        "lastName": "Smith",
        "ageType": 1,
        "birthday": "20100615",
        "gender": "F",
        "nationality": "US",
        "cardNum": "654321098765432",
        "cardExpired": "20280630"
      }
    }
  ],
  "segments": [
    {
      "originalSegments": [
        {
          "tripType": 1,
          "segmentNumber": 1,
          "flightNumber": "CA123",
          "depAirport": "LAX",
          "arrAirport": "ORD",
          "depTime": "202310051000",
          "arrTime": "202310051300"
        }
      ],
      "updatedSegments": [
        {
          "tripType": 1,
          "segmentNumber": 1,
          "flightNumber": "CA456",
          "depAirport": "LAX",
          "arrAirport": "ORD",
          "departureDate": "20231006",
          "depTime": "202310061100",
          "arrTime": "202310061400"
        }
      ]
    }
  ],
  "tickets": [
    {
      "firstName": "John",
      "lastName": "Doe",
      "tripType": 1,
      "segmentNumber": 1,
      "flightNumber": "CA456",
      "ticketNumber": "0123456789",
      "pnr": "ABC123"
    },
    {
      "firstName": "Jane",
      "lastName": "Smith",
      "tripType": 1,
      "segmentNumber": 1,
      "flightNumber": "CA456",
      "ticketNumber": "9876543210",
      "pnr": "ABC123"
    }
  ]
}

Status Code

Name Description
7712 detail failed.

Error-Response

{
    "status": 1000,
    "msg": "General system error"
}
Author：AeroHub  Create time：2026-03-11 18:17
Last editor：AeroHub  Update time：2026-03-19 18:20