Reschedule-Flight Search Quote
- Purpose: reschedule search quotation mode
Supply side provides interface - Request:
POST - Encryption:
No
Request
| Parameter Name |
Type |
Required |
Description |
| requestId |
string |
✅ |
Request ID; unique for each call, 32 bits in length |
| purchaseOrderNo |
string |
✅ |
AeroHub order number |
| changeType |
string |
✅ |
Rescheduling type; VOLUNTARY: voluntary rescheduling INVOLUNTARY: Involuntary rescheduling |
| changeReason |
string |
⬜ |
Reason for involuntary rescheduling; valid when changeType=INVOLUNTARY FLIGHT_CHANGE:Flight change FLIGHT_CANCEL:Flight canceled |
| passengers |
array/passengers Element |
✅ |
Passengers who need to change |
| fromSegments |
array/fromSegments Element |
✅ |
Original return flight segment information that needs to be rescheduled |
| retSegments |
array/retSegments Element |
⬜ |
Original outbound flight segment information that needs to be rescheduled |
array/passengers Element
| Parameter Name |
Type |
Required |
Description |
| lastName |
string |
✅ |
Passenger last name; capitalized |
| firstName |
string |
✅ |
Passenger first name; capitalized |
| birthday |
string |
✅ |
Birthday; format: xxxx-xx-xx |
| cardNo |
string |
⬜ |
ID number |
| ageType |
int |
✅ |
Passenger type; 0: Adult 1:Children 2:baby |
| gender |
string |
✅ |
Passenger gender; F: male, M: female |
| nationality |
string |
⬜ |
Nationality two-character code; ISO country two-character code |
| expired |
string |
⬜ |
Certificate expiration time; format: xxxx-xx-xx |
array/fromSegments Element
| Parameter Name |
Type |
Required |
Description |
| segmentNumber |
int |
✅ |
Line program number; starts with 1 |
| depAirport |
string |
✅ |
Arrival at the airport; three-character airport code |
| arrAirport |
string |
✅ |
Arrival at the airport; three-character airport code |
| flightNumber |
string |
✅ |
flight number |
| depTime |
string |
✅ |
Departure time; format: YYYY-MM-DD HH:MM |
| arrTime |
string |
✅ |
Arrival time; format: YYYY-MM-DD HH:MM |
| newDepDate |
string |
✅ |
New departure date; format: YYYY-MM-DD |
array/retSegments Element
| Parameter Name |
Type |
Required |
Description |
| segmentNumber |
int |
✅ |
Line program number; starts with 1 |
| depAirport |
string |
✅ |
Arrival at the airport; three-character airport code |
| arrAirport |
string |
✅ |
Arrival at the airport; three-character airport code |
| flightNumber |
string |
✅ |
flight number |
| depTime |
string |
✅ |
Departure time; format: YYYY-MM-DD HH:MM |
| arrTime |
string |
✅ |
Arrival time; format: YYYY-MM-DD HH:MM |
| newDepDate |
string |
✅ |
New departure date; format: YYYY-MM-DD |
Sample Request
{
"requestId": "string",
"purchaseOrderNo": "string",
"changeType": "string",
"changeReason": "string",
"passengers": [
{
"ageType": 0,
"gender": "string",
"lastName": "string",
"firstName": "string",
"birthday": "string",
"nationality": "string",
"cardNo": "string",
"expired": "string"
}
],
"fromSegments": [
{
"segmentNumber": 0,
"flightNumber": "string",
"depAirport": "string",
"arrAirport": "string",
"depTime": "string",
"arrTime": "string",
"newDepDate": "string"
}
],
"retSegments": [
{
"segmentNumber": 0,
"flightNumber": "string",
"depAirport": "string",
"arrAirport": "string",
"depTime": "string",
"arrTime": "string",
"newDepDate": "string"
}
]
}
Response
| Parameter Name |
Type |
Required |
Description |
| code |
int |
✅ |
code; 200 indicates success, others indicate failure. Special return values: 201: Order cannot be rescheduled 202: The order does not support automatic quotation and requires manual quotation. |
| msg |
string |
✅ |
Message; general user error message, must be sent when code is not equal to 200 |
| flightList |
array/flightList Element |
✅ |
Flight List; List of flights that can be rescheduled |
array/flightList Element
| Parameter Name |
Type |
Required |
Description |
| amount |
int |
✅ |
Total amount of rescheduling |
| currency |
string |
✅ |
Currency |
| changeFee |
float |
✅ |
Change fee |
| fareDifference |
float |
✅ |
Difference between face and position |
| taxDifference |
float |
⬜ |
Tax position difference |
| costDetails |
array/costDetails Element |
✅ |
price details |
| fromSegments |
array/fromSegments Element |
⬜ |
Outbound flight segment information; data must be returned based on fromSegments in the request parameters. |
| retSegments |
array/retSegments Element |
⬜ |
Return segment information; refer to outbound segment information If the request parameter contains return information, this field must be returned Data must be returned based on retSegments in the request parameters. |
| rules |
object/rules Element |
⬜ |
Customer regulations information |
| routingKey |
string |
✅ |
routingKey |
array/costDetails Element
| Parameter Name |
Type |
Required |
Description |
| changeFee |
int |
✅ |
Change fee |
| passengerType |
int |
✅ |
Passenger Type; 0 Adult 1 Child 2 Infant |
| fareDifference |
int |
✅ |
Par price spread |
| taxDifference |
int |
✅ |
Tax position difference |
array/fromSegments Element
| Parameter Name |
Type |
Required |
Description |
| segmentNumber |
string |
✅ |
Segment number; segment sequence starts from 1 |
| carrier |
string |
✅ |
Airline two-digit code |
| flightNumber |
string |
✅ |
flight number |
| codeShare |
bool |
✅ |
Whether to share flights |
| operatingFlightNumber |
string |
⬜ |
Operating flight number; required when codeShare=true |
| operatingCarrier |
string |
⬜ |
Operating airline; required when codeShare=true |
| depAirport |
string |
✅ |
Departure airport |
| depTerminal |
string |
✅ |
Departure terminal |
| arrAirport |
string |
✅ |
Arrive at the airport |
| arrTerminal |
string |
✅ |
Arrive at the terminal |
| depTime |
string |
✅ |
Departure time; format: YYYY-MM-DD HH:MM |
| arrTime |
string |
✅ |
Arrival time; format: YYYY-MM-DD HH:MM |
| duration |
int |
✅ |
Flight duration; unit: minutes |
| aircraftCode |
string |
✅ |
model |
| stopAirports |
array/stopAirports Element |
⬜ |
Stop information |
| priceList |
array/priceList Element |
✅ |
Fare details |
| cabinClass |
string |
✅ |
Cabin class; cabin class, F first class, C business class, S super economy class, Y economy class |
| seatClass |
string |
✅ |
cabin |
array/stopAirports Element
| Parameter Name |
Type |
Required |
Description |
| stopAirport |
string |
✅ |
Stopover airport; use IATA three-letter code |
| stopDuration |
int |
✅ |
Duration of stoppage; unit: minutes |
| stopCity |
string |
✅ |
Stop cities; use ISO 3166 three-character code |
| stopoverArrivalTime |
string |
✅ |
Arrival time at stopover; format: YYYY-MM-DD HH:MM |
| stopoverDepartureTime |
string |
✅ |
Departure time from stopping place; format: YYYY-MM-DD HH:MM |
array/priceList Element
| Parameter Name |
Type |
Required |
Description |
| fareSequence |
int |
✅ |
- |
| availableCount |
int |
✅ |
- |
| fareKey |
string |
✅ |
- |
| fareBasisCode |
string |
✅ |
- |
| cabinClass |
string |
✅ |
- |
| cabinName |
string |
✅ |
- |
| productClass |
string |
✅ |
- |
| issuePolicyType |
string |
✅ |
- |
| fareTypeCode |
string |
✅ |
- |
| fareTypeDesc |
string |
✅ |
- |
| paxFare |
array/paxFare Element |
✅ |
- |
array/paxFare Element
| Parameter Name |
Type |
Required |
Description |
| passengerType |
int |
✅ |
- |
| publishPrice |
float |
✅ |
- |
| price |
float |
✅ |
- |
| taxFeeAmount |
float |
✅ |
- |
| taxFeeDisclosureList |
array/taxFeeDisclosureList Element |
✅ |
- |
object/rules Element
array/refundInfoList Element
| Parameter Name |
Type |
Required |
Description |
| refundType |
int |
✅ |
- |
| refundStatus |
string |
✅ |
- |
| refundFee |
int |
✅ |
- |
| refNoshowFee |
int |
✅ |
- |
| refNoshow |
string |
✅ |
- |
| refNoShowCondition |
int |
✅ |
- |
| passengerType |
int |
✅ |
- |
| conditionList |
array/conditionList Element |
✅ |
- |
array/conditionList Element
| Parameter Name |
Type |
Required |
Description |
| - |
- |
- |
Source document has undefined fields |
array/changesInfoList Element
| Parameter Name |
Type |
Required |
Description |
| passengerType |
int |
✅ |
- |
| changesType |
int |
✅ |
- |
| changesStatus |
string |
✅ |
- |
| changesFee |
int |
✅ |
- |
| revNoshow |
string |
✅ |
- |
| revNoShowCondition |
int |
✅ |
- |
| revNoShowFee |
int |
✅ |
- |
| conditionList |
array/conditionList Element |
✅ |
- |
array/conditionList Element
| Parameter Name |
Type |
Required |
Description |
| status |
string |
✅ |
- |
| endMinute |
int |
✅ |
- |
| amount |
float |
✅ |
- |
array/formatBaggageDetailList Element
| Parameter Name |
Type |
Required |
Description |
| baggagePiece |
int |
✅ |
- |
| baggageWeight |
int |
✅ |
- |
| flightSeq |
int |
✅ |
- |
| passengerType |
int |
✅ |
- |
| segmentNo |
int |
✅ |
- |
Response Example
Success Response
{
"code": 0,
"msg": "string",
"flightList": [
{
"routingKey": "string",
"amount": 0,
"changeFee": 0,
"fareDifference": 0,
"taxDifference": 0,
"costDetails": [
{
"passengerType": 0,
"changeFee": 0,
"fareDifference": 0,
"taxDifference": 0
}
],
"currency": "string",
"fromSegments": [
{
"segmentNumber": "string",
"carrier": "string",
"flightNumber": "string",
"codeShare": true,
"operatingFlightNumber": "string",
"operatingCarrier": "string",
"depAirport": "string",
"depTerminal": "string",
"arrAirport": "string",
"arrTerminal": "string",
"depTime": "string",
"arrTime": "string",
"duration": 0,
"aircraftCode": "string",
"cabinClass": "string",
"seatClass": "string",
"stopAirports": [
{
"stopAirport": "string",
"stopDuration": 0,
"stopCity": "string",
"stopoverArrivalTime": "string",
"stopoverDepartureTime": "string"
}
],
"priceList": [
{
"fareSequence": 0,
"availableCount": 0,
"fareKey": "string",
"fareBasisCode": "string",
"cabinClass": "string",
"cabinName": "string",
"productClass": "string",
"issuePolicyType": "string",
"fareTypeCode": "string",
"fareTypeDesc": "string",
"bundleId": 0,
"ruleId": "string",
"paxFare": [
{
"passengerType": 0,
"publishPrice": 0,
"price": 0,
"taxFeeAmount": 0,
"taxFeeDisclosureList": [
"string"
]
}
]
}
]
}
],
"retSegments": [
{}
],
"rules": {
"refundInfoList": [
{
"refundType": 0,
"refundStatus": "string",
"refundFee": 0,
"refNoshowFee": 0,
"refNoshow": "string",
"refNoShowCondition": 0,
"passengerType": 0,
"conditionList": [
"string"
]
}
],
"changesInfoList": [
{
"passengerType": 0,
"changesType": 0,
"changesStatus": "string",
"changesFee": 0,
"revNoshow": "string",
"revNoShowCondition": 0,
"revNoShowFee": 0,
"conditionList": [
{
"status": "string",
"endMinute": 0,
"amount": 0
}
]
}
],
"formatBaggageDetailList": [
{
"baggagePiece": 0,
"baggageWeight": 0,
"flightSeq": 0,
"passengerType": 0,
"segmentNo": 0
}
]
}
}
]
}
Author:AeroHub Create time:2026-09-23 17:34
Last editor:AeroHub Update time:2026-09-23 18:00