Change | GetChangeDetail

Detailed information for rescheduling.

Notice:
Product Scope ：FareMarket

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 Rescheduling order number generated by API “SubmitChange”.

Request_Example:

{
  "action": "GetChangeDetail",
  "key": "n93mPT7WzN6cLKC2",
  "signature": "YhQ2EoBQOfOnf/EOnuuuK5i+K+ncydeQhjFpoXYiEMo=",
  "timestamp": 1685116516,
  "request": {
    "changeNum":"C20241018101144760"
  }
}

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 Rescheduling order number generated by API “SubmitChange”.
changeType String Type of rescheduling:
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 rescheduling:
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 Rescheduling order status:
PENDING_QUOTE: pending for quotation
PENDING_CONFIRMATION: pending for confirmation
QUOTE_CONFIRMED: confirmed
PROCESSING: under processing
COMPLETED: completed
REJECTE：rejected
WITHDRAWN：withdrawned
TIMED_OUT：automatically cancelled if not processed for more than 30 minutes after PENDING_CONFIRMATION.
Refer to appendix ‘Change Status List’ for details
attachmentStatus Int Attachment Status:
0: No attachment required
1: Attachment required
rejectReason String Rejection reason.
totalChangeFee Float Total rescheduling fee. Without service fee.
serviceCharge Float Service fee.
quotes Object[] Quotation details.
  ageType Int Passenger type:
0: adult
1: child
2: infant
  changeFee Float Rescheduling fee per person.
  cabinFee Float Cabin difference per person.
passengers Object[] Passenger information for rescheduling.
  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 rescheduling.
  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": "CONFIRMED",
  "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：SunKang  Create time：2024-11-18 17:27
Last editor：AeroHub  Update time：2025-04-22 14:25