Order | GetBookingDetail
Retrieves booking details for the orderNum generated by AeroHub.
Notice:
Product Scope: FareMarket, TechHub, TechHub+
Release note style:
Enhancement: After-sales status visibility in GetBookingDetail
We enhanced GetBookingDetail to improve after-sales tracking at both the passenger level and the order level.
Under
tickets[], we added the following fields:changeStatus,latestChangeNum,cancellationStatus, andlatestCancellationNum.
These fields indicate each passenger’s current change/cancellation status and the latest related application number.At the top level of the response, we added two new nodes:
changeApplicationsandcancellationApplications.
These nodes provide the historical change and cancellation application numbers associated with the order, together with the related passenger IDs for each application.
POST
/flight/bookingParameter
| Field | Mandatory | Type | Scope | Description |
|---|---|---|---|---|
| action | required |
String | GetBookingDetail | |
| key | required |
String | API security key applied from AeroHub | |
| signature | required |
String | Refer to Guideline to generate. | |
| 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. It serves as a unique identifier for bookings made through TechHub and FareMarket, whether for flight bookings or ancillary services. | |
| sync | optional |
int | TechHub+ |
1, for TechHub+ booking, sytem will check and update information below from airline API; - depTime - arrTime - pnrStatus 0 or Null, system retrieve original booking information when booking created. |
Request_Example:
{ "action": "GetBookingDetail", "key": "2n2PMAyqEsnMQrl1", "signature": "WAHzApldOIXbk6Zp3PJq7qUygeRD5W/CaxkoTpFphj0=", "timestamp": 1685116516, "request": { "orderNum": "2031663602599084032", "sync": 0 }
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 |
| contentStatus | int | Return the original code from airlines or suppliers. |
| contentMsg | String | Return the original message from airlines or suppliers, maximum 64 char |
| sessionId | String | Session id : unique identifier.Used for add ssrs to an existing order. |
| orderNum | String | Order number, maximun 100 char |
| postAncillaryInfo | Object[] | After-sales ancillary details from AeroHub |
| ancillaryNum | String | Order number containing after-sales ancillary information |
| status | String | status |
| amount | Float | amount |
| originalAmount | Float | originalAmount |
| currency | String | currency |
| originalCurrency | String | originalCurrency |
| itineraryUrl | String | Itinerary url. Itinerary file download url |
| orderStatus | String | Booking status: TICKETED: ticketing success. refer orderStatus enum from Appendix |
| failureReason | int | failureReason:Incorrect information,Withdraw before issuing,Duplicate booking,Other Rreasons,Fare change,Flight sold out,Ancillary not available,Airline error,Payment card error |
| routeType | int | Data source type, 1,FareMarket 2,TechHub+ 4,TechHub |
| agencyAccountID | String | Agency accountID. For TechHub+, agencyAccountID is the registered agent account at the Airline. For FareMarket and Techhub, agencyAccountID is indicated to a supplier |
| amount | Float | Total cost for payment |
| currency | String | Currency information, 3-Letter Codes e.g. USD |
| originalAmount | Float | Total cost for payment |
| originalCurrency | String | Currency information, 3-Letter Codes e.g. USD |
| segmentCount | Int | Segment count |
| chargeFees | Object[] | Object for charge fee details from AeroHub |
| chargeType | Int | charge Item |
| chargeAmount | Float | amount |
| currency | String | currency |
| passengers | Object[] | Object for Passenger information |
| passengerId | String | Passengerid, start from 0, no duplicate, e.g.: 0, 1, 2, 3, 4, 5. |
| withPassengerId | String | CHD or Infant realted to the adult number. |
| firstName | String | FirstName,in case of middle name, format is firstName middleName |
| lastName | String | LastName |
| birthday | String | Birthday, format: YYYYMMDD |
| gender | String | Gender, M: male F: female |
| ageType | Int | Passenger type: 0:adult 1:child 2:infant |
| nationality | String | Nationality, 2_letter country code |
| cardType | String | Credential Type, PP: Passport ID: Identity number UN: Other Credential Type |
| cardNum | String | Credential Number, maximum 15 char, most case is passport number |
| cardExpired | String | Credential expired date, format: YYYYMMDD |
| cardIssuePlace | String | Credential issued country, country 2_letter code e.g. JP |
| contact | Object | Object for contact information |
| lastName | String | LastName |
| firstName | String | FirstName,in case of middle name, format is firstName middleName |
| mobile | String | Mobile information, format country number + mobile number e.g.: 81-123412341234 |
| String | ||
| address | String | Detail address |
| postCode | String | Post code of address |
| otherPhone | String | Other contact mobile number |
| countryCode | String | National code |
| city | String | City |
| title | String | Contact person title |
| companyName | String | Company name |
| ssrs | Object[] | Object for ssr information |
| orderNum | String | Order number, maximun 100 char |
| emdNumber | String | Airline EMD number. Available for Techhub+. |
| passengerId | String | The passenger id associated with the ssr |
| flightNumber | String | The flightNumber associated with the ssr |
| depAirport | String | The depAirport associated with the ssr |
| arrAirport | String | Arrival airport IATA 3-Letter Codes, The arrAirport associated with the ssr |
| applyType | String | 0: ALL, 1: DURING_BOOKING, 2: POST_BOOKING |
| type | Int | type, 0: checked Baggage; 1: Cabin Baggage; 2: Online Checkin; 3: Cabin Baggage + Priority Boarding Package; |
| code | String | Unique SSR code |
| name | String | Display name of the SSR |
| amount | Float | SSR amount/price |
| currency | String | Currency information, 3_letter code e.g. USD |
| originalAmount | Float | SSR Price |
| originalCurrency | String | Currency information, 3_letter code e.g. USD |
| count | Int | SSR count |
| unit | String | baggage unit, visible when type is 0 |
| weight | Int | baggage weight, visible when type is 0 |
| seats | Object[] | Object for ssr information |
| orderNum | String | Order number, maximun 100 char |
| passengerId | String | The passenger id associated with the ssr |
| flightNumber | String | The flightNumber associated with the ssr |
| depAirport | String | The depAirport associated with the ssr |
| arrAirport | String | Arrival airport IATA 3-Letter Codes, The arrAirport associated with the ssr |
| amount | Float | Seat price |
| currency | String | Currency information, 3_letter code e.g. USD |
| originalAmount | Float | Seat price |
| originalCurrency | String | Currency information, 3_letter code e.g. USD |
| designator | String | Seat identifier, e.g. 1A |
| routing | Object | Object for routing information |
| currency | String | Currency information, 3-Letter Codes e.g. USD |
| originalCurrency | String | Currency information, 3-Letter Codes e.g. USD |
| fromSegments | Object[] | Object for departure route segments. |
| carrier | String | Carrier IATA 2_letter code |
| flightNumber | String | Flight number, e.g. CA123 If the flight number starts with 0, omit the leading zeros. For example, CZ006 should be used as CZ6. |
| codeShare | Boolean | Whether it is a codeshare flight true : yes false: no |
| operatingFlightNumber | String | Actual operating flight number |
| operatingCarrier | String | Actual operating airline. |
| depAirport | String | Departure airport IATA 3-Letter Codes |
| depTerminal | String | Departure terminal |
| arrAirport | String | Arrival airport IATA 3-Letter Codes |
| arrTerminal | String | Arrival terminal |
| depTime | String | Departure date and time, format: YYYYMMDDHHMM e.g. 201203100315 means 2012/03/10 03:15 |
| arrTime | String | Arrival date and time, format: YYYYMMDDHHMM e.g. 201203101305 means 2012/03/10 13:05 |
| aircraftCode | String | aircraftCode |
| stopAirports | Object[] | Stopover airport information |
| airport | String | Stopover airport IATA 3-Letter Codes |
| duration | Int | Stopover duration, unit is minutes |
| duration | Int | Flight duration from departure to arrival, unit in minutes. Available on TechHub only. |
| fares | Object[] | Fare information |
| fareBasisCode | String | Airline-issued code defining fare type, booking class and fare rules. Multiple values separated by semicolons(;). |
| productClass | String | product standardized code by AeroHub, Y(Economy Class), W(Premium Class), C(Business Class), F(First Class) |
| issuePolicyType | String | Filters orders by ticket issuance policy type. The parameter uses a single-letter prefix to indicate the policy category: R: Refund/Change Policy S: PNR Splitting Policy T: Issuance Timing Policy. Multiple policy types can be combined (e.g., R1,S2,T1). R1: Refund/Change follows airline standard policy R2 :Refund/Change policy differs from airline standard; R3: Refund/Change follows airline standard policy; a separate service fee may be charged by the ticketing party; S1:PNR splitting not allowed, S2:PNR splitting by journey (outbound/return) allowed; S3:PNR splitting by passenger type allowed; T1: Issuance time follows SLA agreement, T2: Partner can extend issuance up to 24 hours after payment T3:Partner can delay issuance until the earlier of: - 3 days after payment - 48 hours before travel date |
| cabinClass | String | RBD code generated from airline |
| fareTypeCode | String | Product type code. For TechHub and FareMarket products, the returned value is AeroHubBundle or AirlineBundle. For TechHub+ products, the returned value is the bundlecode defined by the airline. |
| fareTypeDesc | String | return fare type name defines by airline. For reference only. |
| paxFare | Object | fare for all passengers |
| ADT | Object[] | fare for adults |
| chargeType | String | Fare type, e.g. “FairPrice” “Tax” |
| chargeDesc | String | Description of a charge |
| chargeCode | String | chargeCode |
| amount | Float | Fare amount |
| currency | String | currency |
| originalAmount | Float | Fare amount from airlines |
| CHD | Object[] | fare for children |
| chargeType | String | Fare type, e.g. “FairPrice” “Tax” |
| chargeDesc | String | Description of a charge |
| chargeCode | String | chargeCode |
| amount | Float | Fare amount |
| currency | String | currency |
| originalAmount | Float | Fare amount from airlines |
| INF | Object[] | fare for infant |
| chargeType | String | Fare type, e.g. “FairPrice” “Tax” |
| chargeDesc | String | Description of a charge |
| chargeCode | String | chargeCode |
| amount | Float | Fare amount |
| currency | String | currency |
| originalAmount | Float | Fare amount from airlines |
| retSegments | Object[] | |
| carrier | String | Carrier IATA 2_letter code |
| flightNumber | String | Flight number, e.g. CA123 If the flight number starts with 0, omit the leading zeros. e.g. CZ006 should be used as CZ6 |
| codeShare | Boolean | Whether it is a codeshare flight true : yes false: no |
| operatingFlightNumber | String | Actual operating flight number |
| operatingCarrier | String | Actual operating airline. |
| depAirport | String | Departure airport IATA 3-Letter Codes |
| depTerminal | String | Departure terminal |
| arrAirport | String | Arrival airport IATA 3-Letter Codes |
| arrTerminal | String | Arrival terminal |
| depTime | String | Departure date and time, format: YYYYMMDDHHMM e.g. 201203100315 means 2012/03/10 03:15 |
| arrTime | String | Arrival date and time, format: YYYYMMDDHHMM e.g. 201203101305 means 2012/03/10 13:05 |
| stopAirports | Object[] | Stopover airport information |
| airport | String | Stopover airport IATA 3-Letter Codes |
| duration | Int | Stopover duration, unit is minutes |
| duration | Int | Flight duration from departure to arrival, unit in minutes. Available on TechHub only. |
| fares | Object[] | Fare information |
| productClass | String | product standardized code by AeroHub, Y(Economy Class), W(Premium Class), C(Business Class), F(First Class) |
| issuePolicyType | String | Filters orders by ticket issuance policy type. The parameter uses a single-letter prefix to indicate the policy category: R: Refund/Change Policy S: PNR Splitting Policy T: Issuance Timing Policy. Multiple policy types can be combined (e.g., R1,S2,T1). R1: Refund/Change follows airline standard policy R2 :Refund/Change policy differs from airline standard; R3: Refund/Change follows airline standard policy; a separate service fee may be charged by the ticketing party; S1:PNR splitting not allowed, S2:PNR splitting by journey (outbound/return) allowed; S3:PNR splitting by passenger type allowed; T1: Issuance time follows SLA agreement, T2: Partner can extend issuance up to 24 hours after payment T3:Partner can delay issuance until the earlier of: - 3 days after payment - 48 hours before travel date |
| cabinClass | String | RBD code generated from airline. |
| fareTypeCode | String | Product type code. For TechHub and FareMarket products, the returned value is AeroHubBundle or AirlineBundle. For TechHub+ products, the returned value is the bundlecode defined by the airline. |
| fareTypeDesc | String | return fare type name defines by airline. For reference only. |
| paxFare | Object | fare for all passengers |
| ADT | Object[] | fare for adults |
| chargeType | String | Fare type, e.g. “FairPrice” “Tax” |
| chargeCode | String | chargeCode |
| currency | String | currency |
| originalCurrency | String | originalCurrency |
| chargeDesc | String | Description of a charge |
| amount | Float | Fare amount |
| originalAmount | Float | Fare amount from airlines |
| CHD | Object[] | fare for children |
| chargeType | String | Fare type, e.g. “FairPrice” “Tax” |
| chargeCode | String | chargeCode |
| currency | String | currency |
| originalCurrency | String | originalCurrency |
| chargeDesc | String | Description of a charge |
| amount | Float | Fare amount |
| originalAmount | Float | Fare amount from airlines |
| INF | Object[] | fare for infant |
| chargeType | String | Fare type, e.g. “FairPrice” “Tax” |
| chargeCode | String | chargeCode |
| currency | String | currency |
| originalCurrency | String | originalCurrency |
| chargeDesc | String | Description of a charge |
| amount | Float | Fare amount |
| originalAmount | Float | Fare amount from airlines |
| tickets | Object[] | Ticket number list, empty if the order is not in ‘TICKETED’ state. |
| passengerId | String | Passenger Id |
| flightNumber | String | Flight number |
| productClass | String | product standardized code by AeroHub, Y(Economy Class), W(Premium Class), C(Business Class), F(First Class) |
| cabinClass | String | RBD code generated from airline |
| ticketNumber | String | Ticket number returned by the airline. |
| pnr | String | Airline PNR. |
| pnrStatus | String | Actual PNR status returned directly from the airline API. This field is returned only when sync = 1 |
| accountName | String | Account ID provided when airline login credentials are required to manage the booking. |
| accountPass | String | Account password provided when airline login credentials are required to manage the booking. |
| changeStatus | String | Current ticket Change status,more details visit: Change Category |
| latestChangeNum | String | Latest related change application number for this ticket, if any. |
| cancellationStatus | String | Current ticket Cancellation status,more details visit: Cancellation Category |
| latestCancellationNum | String | Latest related cancellation application number for this ticket, if any. |
| airlineOtherFees | Object[] | Details of the payment amount. |
| type | int | Type of amount. 1: Airline discount amount. 2: Airline payment fee. |
| orderNum | String | Order number, maximum 100 characters. |
| desc | String | Description of the payment. |
| originalAmount | Float | Amount in the original currency. |
| originalCurrency | String | The original currency code. |
| amount | Float | Amount in the customer’s quoted currency. |
| currency | String | The customer’s currency code. |
| bundle | Object | Bundle details collection, applicable to TechHub+ products only |
| fareTypeCode | String | Product type code. For TechHub and FareMarket products, the returned value is AeroHubBundle or AirlineBundle. For TechHub+ products, the returned value is the bundlecode defined by the airline. |
| fareTypeDesc | String | Bundle Name. For reference only. |
| carrier | String | Carrier IATA 2_letter code |
| productClass | String | product class code standardized by AeroHub, Y(Economy Class), W(Premium Class), C(Business Class), F(First Class) |
| cabinClass | String | RBD code from airline. |
| cabinBag | Object[] | Carry-on baggage |
| isIncluded | Int | is Included or not 0: No; 1: Yes. |
| piece | Int | Number of Free Carry-on baggage Items |
| weight | Int | Carry-on baggage Allowance, in kilograms (KG) |
| bagType | Int | Refers to baggage weight type 1: Per piece; 2: Total weights. |
| unit | String | Unit |
| category | String | Applicable Scope Domestic International All |
| isFree | Int | is free of charge or not 0: No; 1: Yes. |
| detail | String | Details |
| checkinBag | Object[] | checked baggage |
| isIncluded | Int | is Included or not 0: No; 1: Yes. |
| piece | Int | Number of Free Checked Baggage Items |
| weight | Int | checked baggage Allowance, in kilograms (KG) |
| bagType | Int | Refers to baggage weight type 1: Per piece; 2: Total weights. |
| unit | String | Unit |
| category | String | Applicable Scope Domestic International All |
| isFree | Int | is free of charge or not 0: No; 1: Yes. |
| detail | String | Details |
| seat | Object | Seat Selection Information |
| isIncluded | Int | is Included or not 0: No; 1 Yes. |
| isFree | Int | is free of charge or not 0: No; 1 Yes. |
| detail | String | Details |
| meal | Object | Meal Information |
| isIncluded | Int | is Included or not 0: No; 1: Yes. |
| isFree | Int | is free of charge or not 0: No; 1: Yes. |
| detail | String | Details |
| flightChange | Object[] | Change Rules |
| eligible | Int | is eligible for a change or not 0: No; 1 Yes. |
| category | String | Applicable Scope Domestic International All |
| detail | String | Details |
| cancellation | Object[] | Cancellation Rules |
| eligible | Int | is eligible for a change or not 0: No; 1: Yes. |
| category | String | Applicable Scope Domestic International All |
| detail | String | Details |
| bundleDetail | String | Bundle Details |
| rules | Object[] | Change and Cancellation Rules, Free Baggage Collection, applicable only to FareMarket and Techhub products |
| ruleId | String | Change and Cancellation Rules, Free Baggage ID |
| endorsement | int | Indicates whether ticket endorsement (revalidation or rerouting to another carrier) is supported. 0: Not supported 1: Supported Note:- This applies only when airline fare rules allow endorsement. |
| changeInfoList | Object[] | Change Rules Collection |
| passengerType | int | Passenger Type 0: Adult; 1: Child; 2: Infant. |
| ticketStatus | int | Indicates ticket usage status which affects change rules. 0: Ticket completely unused 1: Ticket partially used (at least one segment flown) Note: - Airline penalties may differ significantly between unused and partially used tickets. |
| changeCategory(Deprecated) | String | Legacy field. Will be deprecated in future versions.Please refer to conditionList.status for detailed change rules. |
| changeFee(Deprecated) | float | Legacy penalty field. Represents airline penalty amount only.Please refer to conditionList.amount for structured rule details. |
| currencyCode | String | Currency information, 3-Letter Codes e.g. USD |
| noshowType | String | Indicates whether a no-show booking is eligible for changes T: Changes not permitted after no-show; H: Changes permitted with conditions or penalty after no-show; F: Changes permitted without penalty after no-show; E: Subject to airline regulations |
| noShowCondition | int | Change deadline for no-shows: Set in hours. Example: If changes are allowed up to 4 hours before departure, the value is ‘4’. Return 0 by default. |
| noShowFee | int | Airline penalty for changing a no-show ticket.Only applicable for change scenarios. For cancellation no-show penalty, refer to cancelInfoList.noShowFee. |
| changeServiceFee(Deprecated) | int | Service fee for ticket change. Retained for backward compatibility only. Not applicable to new integrations. |
| conditionList | Object[] | Reflects various charging rules for different departure times when there are multiple charging rules. |
| status | String | Changes indicator: T:Changes not permitted; H:Changes permitted with conditions or penalty; F:Changes permitted without penalty;, |
| endMinute | int | Time limit for applying for a changes before departure, measured in minutes: >= 0: allowed until N minutes before departure; -1: flight has already departed. For example, if the application is valid 4 hours before departure, assign 240. |
| amount | float | Airline penalty amount for ticket change. Excludes any service fee. Required when Status = H; optional when Status = T or F. |
| cancelInfoList | Object[] | Cancellation Rules Collection |
| passengerType | int | Passenger Type 0: Adult; 1: Child; 2: Infant. |
| ticketStatus | int | Indicates ticket usage status which affects cancel rules. 0: Ticket completely unused 1: Ticket partially used (at least one segment flown) Note: - Airline penalties may differ significantly between unused and partially used tickets. |
| cancelCategory (Deprecated) | String | Legacy field. Will be deprecated in future versions. Please refer to conditionList.status for detailed Cancellation rules. |
| cancelFee (Deprecated) | float | Legacy penalty field. Represents airline penalty amount only. Please refer to conditionList.amount for structured rule details. |
| currencyCode | String | Currency information, 3-Letter Codes e.g. USD |
| noshowType | String | Cancellation rules for No-show, Cancellation Indicator, T: Cancellation not permitted after no-show; H: Cancellation permitted with conditions or penalty after no-show; F: Cancellation permitted without penalty after no-show; E: Subject to airline regulations. |
| noShowCondition | int | Cancel deadline for no-shows: Set in hours. Example: If cancels are allowed up to 4 hours before departure, the value is ‘4’. Return 0 by default. |
| noShowFee | int | Airline penalty charged when cancelling a no-show ticket.Applicable only to cancellation scenarios.This amount represents airline penalty only and does not include service fee. |
| cancelServiceFee(Deprecated) | int | Service fee charged for ticket cancellation. Retained for backward compatibility only. Not applicable to new integrations. |
| conditionList | Object[] | Reflects various charging rules for different departure times when there are multiple charging rules. |
| status | String | Refund indicator: T:Non-refundable, H:Refundable with conditions / penalty applies, F:Refundable without penalty, E:Subject to airline rules. |
| endMinute | int | Time limit for applying for a refund before departure, measured in minutes: >= 0: allowed until N minutes before departure; -1: flight has already departed. For example, if the application is valid 4 hours before departure, assign 240. |
| amount | float | Airline penalty amount for ticket cancellation. Excludes any service fee. Required when Status = H; optional when Status = T or F. |
| freeBagInfoList | Object[] | Free Baggage Information Collection |
| journeyType | int | JourneyType 1: Outbound; 2: Inbound. |
| segmentNo | int | Segment order, starting from 1. Note: For round trips, both outbound and return start from 1 |
| passengerType | int | Passenger Type 0: Adult; 1: Child; 2: Infant. |
| checkinBagPiece | int | Number of Free checked baggage Items.A value of -1 indicates no piece limit. (used in conjunction with checkinBagWeight) |
| checkinBagWeight | int | Free checked baggage Allowance, in kilograms (KG) (used in conjunction with checkinBagPiece) |
| checkinBagWeightType | int | Measurement Method: 1: Per Unit Weight; 2: Total Weight. Default value: 1. Used in conjunction with the checkinBagWeight parameter. |
| carryonBaggagePiece | int | Number of carry-on baggage pieces. A value of -1 indicates no limit on the number of pieces. |
| carryonBaggageWeight | int | carry-on baggage weight in kilograms. Used in conjunction with carryonBaggagePiece. |
| carryonBaggageWeighType | int | Measurement Method: 1: Per Unit Weight; 2: Total Weight. Default value: 1. Used in conjunction with the carryonBaggageWeight parameter. |
| flightChangeList | Object[] | Display all flight change information for this order. |
| changeTime | String | Flight change occurrence time, formatted with “YYYYMMDDHHMMSS”. |
| changeType | int | Type of flight change 1: Flight Cancellation 2: Flight Change (including delay) |
| originalSegments | Object[] | Flight information before change |
| tripType | int | Trip type 1: outbound 2: inbound |
| segmentNumber | String | Segment number, starts from 1. |
| flightNumber | String | Flight number, e.g. CA123. If the flight number starts with 0, omit the leading zeros., e.g. CZ006 should be used as CZ6 |
| depAirport | String | Departure airport IATA 3-Letter Codes |
| depTime | String | Departure date and time, format: YYYYMMDDHHMM e.g. 201203100315 means 2012/03/10 03:15 |
| arrAirport | String | Arrival airport IATA 3-Letter Codes |
| arrTime | String | Arrival date and time, format: YYYYMMDDHHMM e.g. 201203101305 means 2012/03/10 13:05 |
| updatedSegments | Object[] | Flight information after change |
| tripType | int | Trip type 1: outbound 2: inbound |
| segmentNumber | String | Segment number, starts from 1. |
| flightNumber | String | Flight number, e.g. CA123. If the flight number starts with 0, omit the leading zeros. For example, CZ006 should be used as CZ6. |
| depAirport | String | Departure airport IATA 3-Letter Codes |
| depTime | String | Departure date and time, format: YYYYMMDDHHMM e.g. 201203100315 means 2012/03/10 03:15 |
| arrAirport | String | Arrival airport IATA 3-Letter Codes |
| arrTime | String | Arrival date and time, format: YYYYMMDDHHMM e.g. 201203101305 means 2012/03/10 13:05 |
| changeApplications | Object[] | Summary of historical change applications for the current order, sorted by applyTime in ascending order. |
| changeNum | String | Unique change application number. |
| changeStatus | String | Current status of the change application,more details visit: Change Category |
| applyTime | String | Time when the change request was submitted, format: YYYYMMDDHHMMSS. |
| passengerIds | String[] | Passenger IDs associated with this change application. |
| cancellationApplications | Object[] | Summary of historical cancellation applications for the current order, sorted by applyTime in ascending order. |
| cancellationNum | String | Unique cancellation application number. |
| cancellationStatus | String | Current status of the cancellation application,more details visit: Cancellation Category |
| applyTime | String | Time when the cancellation request was submitted, format: YYYYMMDDHHMMSS. |
| passengerIds | String[] | Passenger IDs associated with this cancellation application. |
Success-Response -(Booking details with ancillary services and after-sales change/cancellation information):
{ "status": 0, "msg": "success", "contentStatus": 0, "contentMsg": "success", "sessionId": "a09a5de194903df59b611b60f2aee39a", "orderNum": "2031663602599084032", "itineraryUrl": "https://download.aerohubtech.com/itinerary/2031663602599084032.pdf", "orderStatus": "TICKETED", "failureReason": "", "routeType": 1, "agencyAccountID": "2", "amount": 1718.7, "originalAmount": 1718.7, "currency": "USD", "originalCurrency": "USD", "segmentCount": 4, "fromImport": 0, "createdTime": "20260311172844", "payExpiredTime": "20260311175844", "airlineOtherFees": [ { "type": 2, "orderNum": "2031663602599084032", "desc": "paymentFee", "amount": 0.0, "originalAmount": 0.0, "currency": "USD", "originalCurrency": "USD" } ], "rule": { "endorsement": 0, "cancelInfoList": [ { "cancelFee": 0, "noShowFee": 0, "noshowType": "T", "currencyCode": "USD", "ticketStatus": 0, "conditionList": [], "passengerType": 0, "cancelCategory": "T", "noShowCondition": 0 }, { "cancelFee": 0, "noShowFee": 0, "noshowType": "T", "currencyCode": "USD", "ticketStatus": 1, "conditionList": [], "passengerType": 0, "cancelCategory": "T", "noShowCondition": 0 }, { "cancelFee": 0, "noShowFee": 0, "noshowType": "T", "currencyCode": "USD", "ticketStatus": 0, "conditionList": [], "passengerType": 1, "cancelCategory": "T", "noShowCondition": 0 }, { "cancelFee": 0, "noShowFee": 0, "noshowType": "T", "currencyCode": "USD", "ticketStatus": 1, "conditionList": [], "passengerType": 1, "cancelCategory": "T", "noShowCondition": 0 } ], "changeInfoList": [ { "changeFee": 0, "noShowFee": 0, "noshowType": "T", "currencyCode": "USD", "ticketStatus": 0, "conditionList": [], "passengerType": 0, "changeCategory": "T", "noShowCondition": 0 }, { "changeFee": 0, "noShowFee": 0, "noshowType": "T", "currencyCode": "USD", "ticketStatus": 1, "conditionList": [], "passengerType": 0, "changeCategory": "T", "noShowCondition": 0 }, { "changeFee": 0, "noShowFee": 0, "noshowType": "T", "currencyCode": "USD", "ticketStatus": 0, "conditionList": [], "passengerType": 1, "changeCategory": "T", "noShowCondition": 0 }, { "changeFee": 0, "noShowFee": 0, "noshowType": "T", "currencyCode": "USD", "ticketStatus": 1, "conditionList": [], "passengerType": 1, "changeCategory": "T", "noShowCondition": 0 } ], "freeBagInfoList": [ { "segmentNo": 1, "journeyType": 1, "passengerType": 0, "checkinBagPiece": 2, "checkinBagWeight": 23, "carryonBaggagePiece": 1, "carryonBaggageWeight": 7, "checkinBagWeightType": 1, "carryonBaggageWeighType": 1 }, { "segmentNo": 2, "journeyType": 1, "passengerType": 0, "checkinBagPiece": 2, "checkinBagWeight": 23, "carryonBaggagePiece": 1, "carryonBaggageWeight": 7, "checkinBagWeightType": 1, "carryonBaggageWeighType": 1 }, { "segmentNo": 3, "journeyType": 2, "passengerType": 0, "checkinBagPiece": 2, "checkinBagWeight": 23, "carryonBaggagePiece": 1, "carryonBaggageWeight": 7, "checkinBagWeightType": 1, "carryonBaggageWeighType": 1 }, { "segmentNo": 4, "journeyType": 2, "passengerType": 0, "checkinBagPiece": 2, "checkinBagWeight": 23, "carryonBaggagePiece": 1, "carryonBaggageWeight": 7, "checkinBagWeightType": 1, "carryonBaggageWeighType": 1 } ] }, "passengers": [ { "passengerId": "0", "withPassengerId": "", "firstName": "ROBIN", "lastName": "CHEN", "birthday": "19870318", "gender": "M", "ageType": 0, "nationality": "CN", "cardType": "PP", "cardNum": "E12345678", "cardExpired": "20301231", "cardIssuePlace": "CN" } ], "tickets": [ { "passengerId": "0", "flightNumber": "AI130", "productClass": "Y", "cabinClass": "L", "ticketNumber": "0981234567890", "pnr": "ABCDEF", "pnrStatus": "CONFIRM", "accountName": "", "accountPass": "", "ticketStatus": "TICKETED", "latestChangeNum": "C20260316140823572", "changeStatus": "CHANGED", "latestCancellationNum": "", "cancellationStatus": "" }, { "passengerId": "0", "flightNumber": "AI2354", "productClass": "Y", "cabinClass": "L", "ticketNumber": "0981234567890", "pnr": "ABCDEF", "pnrStatus": "CONFIRM", "accountName": "", "accountPass": "", "ticketStatus": "TICKETED", "latestChangeNum": "C20260316140823572", "changeStatus": "CHANGED", "latestCancellationNum": "", "cancellationStatus": "" }, { "passengerId": "0", "flightNumber": "AI2353", "productClass": "Y", "cabinClass": "L", "ticketNumber": "0981234567890", "pnr": "ABCDEF", "pnrStatus": "CONFIRM", "accountName": "", "accountPass": "", "ticketStatus": "TICKETED", "latestChangeNum": "", "changeStatus": "", "latestCancellationNum": "R20260315233811144", "cancellationStatus": "CANCELED" }, { "passengerId": "0", "flightNumber": "AI129", "productClass": "Y", "cabinClass": "L", "ticketNumber": "0981234567890", "pnr": "ABCDEF", "pnrStatus": "CONFIRM", "accountName": "", "accountPass": "", "ticketStatus": "TICKETED", "latestChangeNum": "", "changeStatus": "", "latestCancellationNum": "R20260315233811144", "cancellationStatus": "CANCELED" } ], "changeApplications": [ { "changeNum": "C20260316140823571", "changeStatus": "REJECTED", "applyTime": "20260308113000", "passengerIds": ["0"] }, { "changeNum": "C20260316140823572", "changeStatus": "CHANGED", "applyTime": "20260309100000", "passengerIds": ["0"] } ], "cancellationApplications": [ { "cancellationNum": "R20260315233811144", "cancellationStatus": "CANCELED", "applyTime": "20260310150000", "passengerIds": ["0"] } ], "routing": { "currency": "USD", "originalCurrency": "USD", "fromSegments": [ { "tripType": 1, "segmentNumber": "1", "carrier": "AI", "flightNumber": "AI130", "depAirport": "LHR", "depTime": "202604100930", "arrAirport": "BOM", "arrTime": "202604102245", "arrTerminal": "2", "depTerminal": "2", "data": "" }, { "tripType": 1, "segmentNumber": "2", "carrier": "AI", "flightNumber": "AI2354", "depAirport": "BOM", "depTime": "202604110700", "arrAirport": "BLR", "arrTime": "202604110845", "arrTerminal": "1", "depTerminal": "2", "data": "" } ], "retSegments": [ { "tripType": 2, "segmentNumber": "3", "carrier": "AI", "flightNumber": "AI2353", "depAirport": "BLR", "depTime": "202604201030", "arrAirport": "BOM", "arrTime": "202604201215", "arrTerminal": "2", "depTerminal": "1", "data": "" }, { "tripType": 2, "segmentNumber": "4", "carrier": "AI", "flightNumber": "AI129", "depAirport": "BOM", "depTime": "202604201430", "arrAirport": "LHR", "arrTime": "202604201915", "arrTerminal": "2", "depTerminal": "2", "data": "" } ] }, "postAncillaryInfo": [], "chargeFees": [], "contact": { "lastName": "CHEN", "firstName": "ROBIN", "mobile": "86-13800138000", "email": "robin.chen@example.com", "address": "Shanghai, China", "postCode": "200000", "otherPhone": "", "countryCode": "CN", "city": "Shanghai", "title": "Mr", "companyName": "" }, "ssrs": [], "seats": [] }
Status Code
| Name | Description |
|---|---|
| 1000 | General system error |
| 1001 | Request parameters or part of parameters missing |
| 1002 | Invalid Action |
| 1003 | API request timeout, please request again |
| 1004 | Invalid request parameter |
| 1005 | Service system error |
| 1006 | System busy, please try again |
| 1101 | Authentication fail, wrong signature |
| 1102 | Account disabled, please contact with account administrator |
Error-Response
{ "status": 1000, "msg": "Letslfy flight internal error" }
Last editor:AeroHub Update time:2026-03-19 18:20