Search API
Get airport list API
GET: /metasrv/api/_search/airports
Search for airports by relevant keywords or country/region codes Allows to sort the returned results
Parameter
query (String, Optional)
Search keyword area / airport name (eg: SGN, Vietnam, Tokyo)
country (String, Optional)
Country/Region Code (Example: VN)
page (Integer, Optional)
Number of pages you want to get results (eg: 0)
size (Integer, Optional)
Number of results you want to get in 1 page (eg 20)
sort (String, Optional)
Sort the results by the value of the returned property ascending or descending (eg: propertiesName,desc / propertiesName,asc)
Example
?query=ha
&country=VN
&page=0
&size=20
&sort=name,desc
Response
Model
Array[AirportDTO] (Optional)
Return airport list information
id (Long, Optional)
Airport List Identifier
code (String, Optional)
Airport code
name (String, Optional)
Airport name
cityCode (String, Optional)
City symbol code
city (String, Optional)
City name
countryCode (String, Optional)
Country symbol code
country (String, Optional)
Country name
timeZone (Integer, Optional)
Time zone
location (String, Optional)
Location name
name2 (String, Optional)
English airport name (other name)
city2 (String, Optional)
English city name (other name)
Example
[
{
"id": 4,
"code": "SGN",
"name": "Sân bay Tân Sơn Nhất",
"cityCode": "SGN",
"city": "Hồ Chí Minh",
"countryCode": "VN",
"country": "Vietnam",
"iata": "SGN",
"groupName": "Popular,INT_VN,Vietnam",
"name2": "Tansonnhat Intl",
"city2": "Ho Chi Minh City",
"location": "Tp. Hồ Chí Minh",
"timezone": 7,
"index": 2,
"icao": null,
"latitude": null,
"longitude": null,
"altitude": null,
"dts": null,
"tzTimezone": null,
"updatedAt": null,
"connectedPorts": null,
"stateCode": null,
"status": null,
"keywords": null
}
]
Search flight ticket API
GET: /api/air-tickets/low-fare-search-async
Search for flights by departure and end points / by date and time
Parameter
origin_code (String, Required)
Departure airport code Example: The airport in Ho Chi Minh has the code SGN
destination_code (String, Required)
Destination airport code Example, the airport in Hanoi has the code HAN .
departure_date (String, Required)
Departure day Format in MM-dd-YYYY Example: 07-07-2021
returnure_date (String, Required)
Return day Format in MM-dd-YYYY Example: 08-20-2021
cabin_class (String, Required)
Ticket class Pass the value as E
route_type (String, Optional)
Journey type: - Oneway: One-way - ROUNDTRIP: Round trip If not transmitted, the value is ONEWAY .
aduts_qtt (Integer, Optional)
Number of adult passengers (12 years old and above) Otherwise, the default value is 1 .
children_qtt (Integer, Optional)
Number of passengers who are children (from 2 years old and under 12 years old) Otherwise, the default value is 0
infant_qtt (Integer, Optional)
Number of passengers who are infants (under 2 years old) Otherwise, the default value is 0
time (String, Optional)
API Call Time (UnixTimeStamp) Example: 1625545845
key (String, Optional)
Key to checksum. How to create value:MAC-SHA256(, ‘Gotadi’)
include-equivfare (Boolean, Optional)
Request to pay additional ticketing fee information (EquivFare)
page (Integer, Optional)
Number of pages you want to get results (eg: 0)
size (Integer, Optional)
Number of results you want to get in 1 page (eg 20)
sort (String, Optional)
Sort the results by the value of the returned property ascending or descending (eg: propertiesName,desc / propertiesName,asc)
Example
?origin_code=SGN&destination_code=HAN&departure_date=07-21-2021&returnture_date=07-28-2021&cabin_class=E&route_type=ROUNDTRIP&aduts_qtt=1&children_qtt=0&infants_qtt=0&time=1625552814666&key=/xNr15RmY0dqSUkhvpKI1bIbKIuyZr1Q38rLi3bqxVk=&page=0&size=15
Response
Model
searchId(String, Required)
The reference code to the search for air tickets, taken from the search results for air tickets
departureSearchId(String, Required)
Reference code to search for flight tickets Retrieved from searchId
returnSearchId(String, Required)
Reference code to search for air tickets Derived from searchID combined with -R at the end
groupPricedItineraries (Array[GroupPricedItineraryDTO], Optional)
Information about the list of journeys returned by search results
airSupplier(String, Required)
Carriers (VietnamAirline - VNA, VjetJet - VJ, BamBoo - QH, …)
aircraft (String, Optional)
Type of aircraft (Airbus A330, Boeing 787, .....)
airline(String, Optional)
Airlines (VJ, VNA, …)
airlineName(String, Optional)
Name of airline (Vietjet Air, Vietnam Airlines, Bamboo, …)
arrivalDateTime(String, Required)
Arrival date and time, using UTC/GMT+7 time zone
departureDateTime (String, Required)
Split flight time, using UTC/GMT+7 time zone
destinationLocationCode (String, Optional)
Flight end city code
destinationCountry(String, Optional)
The name of the country where the flight ended
destinationCountryCode (String, Optional)
Flight end country code
destinationCity(String, Optional)
The name of the city where the flight ends
destinationLocationName (String, Optional)
Airport name where the flight ends
flightNo(String, Optional)
Airplane number
flightNo(String, Optional)
Airplane number
flightType(String, Optional)
Type of flight domestic or international DOMESTIC: domestic INTERNATIONAL: international
groupId(String, Required)
Journey identifier in the list of journeys returned by search results
originCity(String, Optional)
City name at departure point
originCountry(String, Optional)
Country name at departure point
originCountryCode(String, Optional)
Country code at departure point
originLocationCode(String, Optional)
Flight departure city code
originLocationName(String, Optional)
Airport name at departure point
totalPricedItinerary (Integer, Required)
Total number of detailed journeys
pricedItineraries (Array[PricedItineraries], Required)
Itinerary details
airItineraryPricingInfo (AirItineraryPricingInfo, Required)
Detailed price information of the itinerary
adultFare (FareBreakdown, Required)
passengerFare (PassengerFare, Required)
Adult fare information
baseFare(FareInfo, required)
Basic fare information
amount (Double, Required)
Amount of money
decimalPlaces(Integer, Optional)
Decimal places rounded to
equivFare (FareInfo, Optional)
Similar to baseFare Ticketing fee information
serviceTax (FareInfo, Required)
Similar to baseFare Service fee information
totalFare (FareInfo, Required)
Similar to baseFare Total ticket price information
surcharges (Array[Surcharge], Required)
Information about surcharges per booking / per segment
passengerTypeQuantities (PassengerTypeQuantities, Optional)
Number/type of passengers
code(String, Required)
Adult/Child/Infant Identifier Includes: ADT - adult / CHD - child / INF - infant
quantity (Integer, Required)
Number of adults / children / infants
childFare(PassengerFare, Optional)
Child fare information Similar to adult fare information
infantFare (PassengerFare, Optional)
Infant fare information Similar to adult fare information
itinTotalFare (PassengerFare, Required)
Total fare information of the journey Similar to adult fare information
fareSourceCode(String, Required)
Journey identifier information Used to get ticket condition information
allowHold (Boolean, Required)
Information to allow to hold a reservation or not
cabinClassName(String, Required)
Seat class information: ECONOMY - universal seat PREMIUM - special economy seat BUSINESS - business chair
fightNo(String, Optional)
Displays aircraft number information
originDestinationOptions (Array(OriginDestinationOptions), Required)
Cruise’s blocking/stopping information
flightDirection(String, Required)
Show flight direction information of the journey D - departure direction R - return direction
journeyDuration (Integer, Required)
Show flight time
flightSegments (Array(FlightSegments), Required)
Show detailed information of departure / end points in the journey
page (AirPage, Required)
Object that describes information about pagination. Sequence number of each page returned, element of each page, total number of pages
duration(Integer, Optional),
errors (Array[Error], Optional)
infos(Array[Info], Optional)
success(Boolean, Optional)
textMessage(String, Optional)
Example
{
"returnSearchId": "ATD::210706::519f4508-b6df-4d96-8d43-538c96a0d90b-R",
"departureSearchId": "ATD::210706::519f4508-b6df-4d96-8d43-538c96a0d90b",
"duration": 46854,
"errors": null,
"groupPricedItineraries": [
{
"airSupplier": "VJ",
"aircraft": "Airbus A330",
"vnaArea": null,
"airline": "VJ",
"airlineName": "VietJet Air",
"arrivalDateTime": "2021-07-21T21:45:00.000Z",
"departureDateTime": "2021-07-21T19:35:00.000Z",
"destinationCity": "Hà Nội",
"destinationCountry": "Vietnam",
"destinationCountryCode": "VN",
"destinationLocationCode": "HAN",
"destinationLocationName": "Sân bay Nội Bài",
"fightNo": "156",
"flightType": "DOMESTIC",
"groupId": "599a7a20-32b8-4e6b-b167-27feb4f324f5",
"originCity": "Hồ Chí Minh",
"originCountry": "Vietnam",
"originCountryCode": "VN",
"originLocationCode": "SGN",
"originLocationName": "Sân bay Tân Sơn Nhất",
"pricedItineraries": [
{
"airItineraryPricingInfo": {
"adultFare": {
"fareBasisCodes": null,
"passengerFare": {
"baseFare": {
"amount": 399000,
"currencyCode": null,
"decimalPlaces": 2
},
"comboMarkup": null,
"equivFare": null,
"serviceTax": {
"amount": 258900,
"currencyCode": null,
"decimalPlaces": 2
},
"surcharges": [
{
"amount": 0,
"indicator": "Ticket fee per segment",
"type": "Ticket fee per segment"
}
],
"taxes": null,
"totalFare": {
"amount": 657900,
"currencyCode": null,
"decimalPlaces": 2
},
"totalPaxFee": null
},
"passengerTypeQuantities": {
"code": "ADT",
"quantity": 1
}
},
"childFare": null,
"divideInPartyIndicator": false,
"fareInfoReferences": null,
"fareSourceCode": "dom5226c7ae-e46c-48de-ae99-a7d4e3bf0782",
"fareType": "PUBLIC",
"infantFare": null,
"itinTotalFare": {
"baseFare": {
"amount": 399000,
"currencyCode": null,
"decimalPlaces": 2
},
"comboMarkup": null,
"equivFare": null,
"serviceTax": {
"amount": 258900,
"currencyCode": null,
"decimalPlaces": 2
},
"totalFare": {
"amount": 657900,
"currencyCode": null,
"decimalPlaces": 2
},
"totalPaxFee": null,
"totalTax": {
"amount": 0,
"currencyCode": null,
"decimalPlaces": 2
}
}
},
"allowHold": true,
"baggageItems": [
{
"amount": 0,
"code": "air-tickets.baggage-items.vietnam.vj.economy.baggage.adult.free",
"direction": null,
"fareCode": null,
"id": "air-tickets.baggage-items.vietnam.vj.economy.baggage.adult.free",
"name": "7kg xách tay",
"serviceType": "BAGGAGE"
}
],
"cabinClassName": "ECONOMY",
"directionInd": "DEPARTURE",
"fightNo": "156",
"mealItems": null,
"onlyPayLater": false,
"originDestinationOptions": [
{
"cabinClassName": "ECONOMY",
"destinationCity": "Hà Nội",
"destinationDateTime": "2021-07-21T21:45:00.000Z",
"destinationLocationCode": "HAN",
"destinationLocationName": "Sân bay Nội Bài",
"flightDirection": "D",
"flightSegments": [
{
"adultBaggage": null,
"aircraft": "Airbus A330",
"arrivalAirportLocationCode": "HAN",
"arrivalAirportLocationName": "Sân bay Nội Bài",
"arrivalCity": "Hà Nội",
"arrivalDateTime": "2021-07-21T21:45:00.000Z",
"cabinClassCode": "Z1_ECO",
"cabinClassName": "ECONOMY",
"cabinClassText": "Economy",
"childBaggage": null,
"departureAirportLocationCode": "SGN",
"departureAirportLocationName": "Sân bay Tân Sơn Nhất",
"departureCity": "Hồ Chí Minh",
"departureDateTime": "2021-07-21T19:35:00.000Z",
"eticket": true,
"fareBasicCode": null,
"fareCode": null,
"flightDirection": "D",
"flightNumber": "156",
"infantBaggage": null,
"journeyDuration": 130,
"marketingAirlineCode": "VJ",
"marriageGroup": null,
"mealCode": null,
"operatingAirline": {
"code": "VJ",
"equipment": null,
"flightNumber": "156",
"name": "VietJet Air"
},
"resBookDesignCode": "Z1_ECO",
"seatsRemaining": null,
"stopQuantity": 0,
"stopQuantityInfo": null,
"supplierFareKey": null,
"supplierJourneyKey": "qPHglSL8tSGƒ3tYhxs32unUB07y8mK5BDYQX2BnPQJuYvXBionML¥MStNiƒK98yyAOIpSQgCYƒdoFP¥a2VnwgUPQJAmkk89BX1s9VLDde6FRhlAFf34qJAHS3DNEEwbaCBRcmqPevNTjFuizmUVPBSKBj6HlNSuyrpPZEREJgN8ThsfKqQnB6zAkEhnwV0rNNPzwWYQqRMFAZYiXy5p0roZGgAxbnU6itFQzVmWzpƒƒd1GUseZ6vDwLWRqbO2lnJcw7qbRbSƒ9Lw0btZKtBHz2zAUgpGG97MNdAf1xN2g2cFSƒxTc7lrjWfIJsC53YbqXvqMhzgmUSDj¥B5dxg4bloOeLI5¥YWAlkIGawk57IcgpyzGprHK5Pn3Bv2CR4sMsg7ey0Z5eGFvalCScS72idlrgHBzOYnbwZ21mkGjsXVus¥ƒoEJSpWVB3meJug14SIGSd88mzGXtT4ƒQg1Tam4wvySRzi9gO4QGGXpcbBF4ƒs="
}
],
"journeyDuration": 130,
"originCity": "Hồ Chí Minh",
"originDateTime": "2021-07-21T19:35:00.000Z",
"originLocationCode": "SGN",
"originLocationName": "Sân bay Tân Sơn Nhất"
}
],
"passportMandatory": true,
"refundable": false,
"sequenceNumber": "ibe3541984955292126",
"ticketType": "ETICKET",
"validReturnCabinClasses": null,
"validatingAirlineCode": "VJ",
"validatingAirlineName": "VietJet Air"
}
],
"requiredFields": null,
"returnDateTime": null,
"roundType": "ROUNDTRIP",
"totalPricedItinerary": 3
}
],
"infos": null,
"page": {
"nextPageNumber": 1,
"offset": 15,
"pageNumber": 0,
"previousPageNumber": -1,
"totalElements": 57,
"totalPage": 4
},
"searchId": "ATD::210706::519f4508-b6df-4d96-8d43-538c96a0d90b",
"success": true,
"textMessage": null
}
Get filter list information API
POST: /api/air-tickets/filter-options
Get a list of values that can be applied on the filter on the search results
Request Body
searchId (String, Required)
Data used to refer to search results This data is taken from the return results of airline ticket search
departureItinerary (AirItineraryInfo, Optional)
Outbound ticket information in case of getting filter-options for return ticket
airlineCode (String, Required)
VN: Vietnam Airlines VJ: VietJet QH: Bamboo BL: Pacific Airlines…
groupId (String, Required)
Journey identifier in the list of journeys returned by search results
fareSourceCode (String, Required)
Journey identifier information
supplierCode (String, Required)
The company code is also provided
searchId (String, Required)
Data used to refer to search results
Example
{
"searchId": "ATD::210707::01a59301-d1f7-4302-954a-7047ee06e001-R",
"departureItinerary": {
"groupId": "01e650b9-2771-48cb-80fa-3004d0bd9eef",
"airlineCode": "VN",
"fareSourceCode": "dom5fb76509-3ac6-4c7b-baaa-b1ea844e3d7e",
"supplierCode": "VN",
"searchId": "ATD::210707::01a59301-d1f7-4302-954a-7047ee06e001"
}
}
Response
searchId(String, Required)
The reference code to the search for air tickets, taken from the search results for air tickets
itineraryFilter (ItineraryFilter, Required)
Information representing applicable values on search filter results
airlineOptions (Array[String], Optional)
Information showing airlines with the lowest fares
cabinClassOptions (Array[String], Optional)
Information showing current seat class
stopOptions (Array[String], Optional)
Information showing current stop
filterToPrice (Double, Optional)
Information showing the current highest ticket price
filterFromPrice (Double, Optional)
Information showing the current lowest fares
duration (Integer, Optional),
errors (Array[Error], Optional),
infos (Array[Info], Optional),
success (Boolean, Optional),
textMessage (String, Optional)
Example
{
"isSuccess" : true,
"duration" : 1131,
"textMessage" : null,
"errors" : null,
"infos" : null,
"searchId" : "ATD::210707::01a59301-d1f7-4302-954a-7047ee06e001-R",
"itineraryFilter" : {
"airlineOptions" : [ "VJ:VietJet Air:657900.0", "QH:Bamboo Airways:1461000.0", "BL:Pacific Airlines:2054000.0", "VN:Vietnam Airlines:2164000.0" ],
"arrivalDateTimeOptions" : null,
"arrivalDateTimeReturnOptions" : null,
"cabinClassOptions" : [ "ECONOMY", "PREMIUM", "BUSINESS" ],
"departureDateTimeOptions" : null,
"departureDateTimeReturnOptions" : null,
"flightType" : null,
"groupId" : null,
"loadMore" : null,
"minPrice" : null,
"filterToPrice" : 5202000.0,
"filterFromPrice" : 657900.0,
"priceItineraryId" : null,
"step" : null,
"stopOptions" : [ "1" ],
"ticketPolicyOptions" : null
},
"success" : true
}
Filter/sort flight search results API
POST: /api/air-tickets/filter-availability
Filter and sort flight search results
Paramaters
include-equivfare (Boolean, Optional)
Request to pay more ticketing fee information
page (Integer, Optional)
Number of pages you want to get results (eg: 0)
size (Integer, Optional)
Number of results you want to get in 1 page (eg: 20)
sort(String, Optional)
Sort the results by the value of the returned property ascending or descending (eg: propertiesName,desc / propertiesName,asc)
Example
?include-equivfare=false
&page=0
&size=20
&sort=departureDate,asc
Request Body
searchId(String, Required)
Data used to refer to search results This data is taken from the return results of airline ticket search
departureItinerary (AirItineraryInfo, Optional)
Outbound ticket information in case of getting filter-availability for return ticket
airlineCode (String, Required)
VN: Vietnam Airlines VJ: VietJet QH: Bamboo BL: Pacific Airlines…
groupId(String, Optional)
Journey identifier in the list of journeys returned by search results
fareSourceCode(String, Required)
Journey identifier information
supplierCode(String, Required)
The company code is also provided
searchId(String, Required)
Data used to refer to search results
filter (ItineraryFilter, Required)
Used to input the desired filtering and sorting criteria
cabinClassOptions(Array[String], Optional)
Information about the seat class you want to filter and sort
step(String, Required)
Information used to distinguish between departure and return 1: Departure direction 2: Return direction
flightType(String, Required)
Flight type information DOMESTIC: domestic INTERNATIONAL: international
stopOption(Array[String], Optional)
Stop Information
airlineOptions(Array[String], Optional)
Airline information
departureDateTimeOptions (Array[String], Optional)
Information about departure time starts at around or at what time Ex: departureDateTimeOptions: [“+18”, “+12-18”] +18: from 18h to 24h +12-18: from 12pm to 6pm
arrivalDateTimeReturnOptions (Array[String], Optional)
The end time information starts at what time or interval Ex: arrivalDateTimeReturnOptions: [“+18”, “+12-18”] +18: from 18h to 24h +12-18: from 12pm to 6pm
Example
{
"searchId": "ATD::210707::01a59301-d1f7-4302-954a-7047ee06e001",
"filter": {
"cabinClassOptions": [],
"ticketPolicyOptions": [],
"airlineOptions": [],
"stopOptions": [],
"step": "1",
"flightType": "DOMESTIC",
"departureDateTimeOptions": [],
"arrivalDateTimeReturnOptions": [],
"arrivalDateTimeOptions": [],
"priceItineraryId": "",
"loadMore": false,
"departureDateTimeReturnOptions": []
},
"departureItinerary": null
}
Response
Model
searchId(String, Required)
The reference code to the search for air tickets, taken from the search results for air tickets
groupPricedItineraries (Array[GroupPricedItineraryDTO], Optional)
Information about the list of journeys returned by search results
airSupplier(String, Required)
Carriers (VietnamAirline - VNA, VjetJet - VJ, BamBoo - QH, …)
aircraft (String, Optional)
Type of aircraft (Airbus A330, Boeing 787, .....)
airline (String, Optional)
Airlines (VJ, VNA, …)
airlineName (String, Optional)
Name of airline (Vietjet Air, Vietnam Airlines, Bamboo, …)
arrivalDateTime (String, Required)
Arrival date and time, using UTC/GMT+7 time zone
departureDateTime (String, Required)
Split flight time, using UTC/GMT+7 time zone
destinationLocationCode (String, Optional)
Flight end city code
destinationCountry (String, Optional)
The name of the country where the flight ended
destinationCountryCode (String, Optional)
Flight end country code
destinationCity (String, Optional)
The name of the city where the flight ends
destinationLocationName (String, Optional)
Airport name where the flight ends
flightNo (String, Optional)
Airplane number
flightNo (String, Optional)
Airplane number
flightType (String, Optional)
Type of flight domestic or international? Flight type: DOMESTIC: domestic INTERNATIONAL: international
groupId(String, Required)
Journey identifier in the list of journeys returned by search results
originCity(String, Optional)
City name at departure point
originCountry(String, Optional)
Country name at departure point
originCountryCode(String, Optional)
Country code at departure point
originLocationCode(String, Optional)
Flight departure city code
originLocationName(String, Optional)
Airport name at departure point
totalPricedItinerary (Integer, Required)
Total number of detailed journeys
pricedItineraries (Array[PricedItineraries], Required)
Itinerary details
airItineraryPricingInfo (AirItineraryPricingInfo, Required)
Detailed price information of the itinerary
adultFare (FareBreakdown, Required)
passengerFare (PassengerFare, Required)
Adult fare information
baseFare(FareInfo, required)
Basic fare information
amount (Double, Required)
Amount of money
decimalPlaces(Integer, Optional)
Decimal places rounded to
equivFare (FareInfo, Optional)
Similar to baseFare Ticketing fee information
serviceTax (FareInfo, Required)
Similar to baseFare Service fee information
totalFare (FareInfo, Required)
Similar to baseFare Total ticket price information
surcharges (Array[Surcharge], Required)
Information about surcharges per booking / per segment
passengerTypeQuantities (PassengerTypeQuantities, Optional)
Number/type of passengers
code(String, Required)
Adult/Child/Infant Identifier Includes: ADT - adult / CHD - child / INF - infant
quantity (Integer, Required)
Number of adults / children / infants
childFare(PassengerFare, Optional)
Child fare information Similar to adult fare information
infantFare (PassengerFare, Optional)
Infant fare information Similar to adult fare information
itinTotalFare (PassengerFare, Required)
Total fare information of the journey Similar to adult fare information
fareSourceCode(String, Required)
Journey identifier information Used to get ticket condition information
allowHold (Boolean, Required)
Information to allow to hold a reservation or not
cabinClassName(String, Required)
Seat class information: ECONOMY - universal seat PREMIUM - special economy seat BUSINESS - business chair
fightNo(String, Optional)
Displays aircraft number information
originDestinationOptions (Array(OriginDestinationOptions), Required)
Cruise’s blocking/stopping information
flightDirection(String, Required)
Show flight direction information of the journey D - departure direction R - return direction
journeyDuration (Integer, Required)
Show flight time
flightSegments (Array(FlightSegments), Required)
Show detailed information of departure / end points in the journey
page (AirPage, Required)
Object that describes information about pagination. Sequence number of each page returned, element of each page, total number of pages
duration(Integer, Optional),
errors (Array[Error], Optional)
infos(Array[Info], Optional)
success(Boolean, Optional)
textMessage(String, Optional)
Example
{
"searchId": "ATD::210707::1f5e34da-24d5-46bf-993e-8cda8d716d15",
"duration": 1034,
"errors": null,
"groupPricedItineraries": [
{
"airSupplier": "VN",
"aircraft": "Airbus A321",
"vnaArea": "NorthTrip",
"airline": "VN",
"airlineName": "Vietnam Airlines",
"arrivalDateTime": "2021-07-23T07:15:00.000Z",
"departureDateTime": "2021-07-23T05:00:00.000Z",
"destinationCity": "Hồ Chí Minh",
"destinationCountry": "Vietnam",
"destinationCountryCode": "VN",
"destinationLocationCode": "SGN",
"destinationLocationName": "Sân bay Tân Sơn Nhất",
"fightNo": "205",
"flightType": "DOMESTIC",
"groupId": "8527f1e5-5291-42cf-8b76-c6874889b6c6",
"originCity": "Hà Nội",
"originCountry": "Vietnam",
"originCountryCode": "VN",
"originLocationCode": "HAN",
"originLocationName": "Sân bay Nội Bài",
"pricedItineraries": [
{
"airItineraryPricingInfo": {
"adultFare": {
"fareBasisCodes": null,
"passengerFare": {
"baseFare": {
"amount": 2739000,
"currencyCode": null,
"decimalPlaces": 2
},
"comboMarkup": null,
"equivFare": null,
"serviceTax": {
"amount": 844000,
"currencyCode": null,
"decimalPlaces": 2
},
"surcharges": [
{
"amount": 0,
"indicator": "Ticket fee per segment",
"type": "Ticket fee per segment"
}
],
"taxes": null,
"totalFare": {
"amount": 3583000,
"currencyCode": null,
"decimalPlaces": 2
},
"totalPaxFee": null
},
"passengerTypeQuantities": {
"code": "ADT",
"quantity": 1
}
},
"childFare": null,
"divideInPartyIndicator": false,
"fareInfoReferences": null,
"fareSourceCode": "dom2ac8e775-85a1-4a3a-a945-7c2e8eee905e",
"fareType": "PUBLIC",
"infantFare": null,
"itinTotalFare": {
"baseFare": {
"amount": 2739000,
"currencyCode": null,
"decimalPlaces": 2
},
"comboMarkup": null,
"equivFare": null,
"serviceTax": {
"amount": 844000,
"currencyCode": null,
"decimalPlaces": 2
},
"totalFare": {
"amount": 3583000,
"currencyCode": null,
"decimalPlaces": 2
},
"totalPaxFee": null,
"totalTax": {
"amount": 0,
"currencyCode": null,
"decimalPlaces": 2
}
}
},
"allowHold": true,
"baggageItems": [
{
"amount": 0,
"code": "air-tickets.baggage-items.vn.adult-child.12kg-1x23kg.free",
"direction": null,
"fareCode": null,
"id": "air-tickets.baggage-items.vn.adult-child.12kg-1x23kg.free",
"name": "Xách tay 12kg + Ký gửi 1x23kg",
"serviceType": "BAGGAGE"
}
],
"cabinClassName": "ECONOMY",
"directionInd": "DEPARTURE",
"fightNo": "205",
"mealItems": null,
"onlyPayLater": false,
"originDestinationOptions": [
{
"cabinClassName": "ECONOMY",
"destinationCity": "Hồ Chí Minh",
"destinationDateTime": "2021-07-23T07:15:00.000Z",
"destinationLocationCode": "SGN",
"destinationLocationName": "Sân bay Tân Sơn Nhất",
"flightDirection": "D",
"flightSegments": [
{
"adultBaggage": null,
"aircraft": "Airbus A321",
"arrivalAirportLocationCode": "SGN",
"arrivalAirportLocationName": "Sân bay Tân Sơn Nhất",
"arrivalCity": "Hồ Chí Minh",
"arrivalDateTime": "2021-07-23T07:15:00.000Z",
"cabinClassCode": "M",
"cabinClassName": "ECONOMY",
"cabinClassText": "Economy Flex",
"childBaggage": null,
"departureAirportLocationCode": "HAN",
"departureAirportLocationName": "Sân bay Nội Bài",
"departureCity": "Hà Nội",
"departureDateTime": "2021-07-23T05:00:00.000Z",
"eticket": true,
"fareBasicCode": null,
"fareCode": null,
"flightDirection": "D",
"flightNumber": "205",
"infantBaggage": null,
"journeyDuration": 135,
"marketingAirlineCode": "VN",
"marriageGroup": null,
"mealCode": null,
"operatingAirline": {
"code": "VN",
"equipment": null,
"flightNumber": "205",
"name": "Vietnam Airlines"
},
"resBookDesignCode": "M",
"seatsRemaining": null,
"stopQuantity": 0,
"stopQuantityInfo": null,
"supplierFareKey": null,
"supplierJourneyKey": "b+T7Lz8Bk6JHev8ZaYn6JdksP71z9ZD2metfP5B9ooYsM9jko+XIuxjgA14ghnjgUaj450N5VDUtJjP9AGhuOW+4XTufOS5VZDXm0TvXcwMXZzjJrTD4yzKE2HcSkpV2GU4fA4JI8HBo2DdLJAOlMuSGTpcN0/ylBtnM8MWr9faFvtwUUNLcIEma87mvAT2djGS7D2B65bkfIudjgUgMzxbClvY862C1Fkqt6J1iU8QvNRJygV+tIM581jkWISXEqEBWynub65QcCSh37U/HZ7vCCNWM0CbjqbnEJDbIFDJMWEPs/reBsAdLJ1oQVj/XMMOfVyWYykSzqBjrSxEbjlC2kfUf/qcH2a+VjzSftFZ4xgxv9BVcyjEvt6nfFl9eNxB0u2sH6O6Jr+V4yhqo8MHUvHs61leE3ihqaZr2WOW0tagXPQjFe/IRySSO/gsZvNE8SnbYsjkmvY0YDSdfgzGbkxJQVHTcIztxg1JG5c0MlwrGdbVINsLXyL9s5TOANlBpNtr9ArzEcr2/M7lZy4PjAlRZqPhyAl6dK4cR1gZaz/P+LivHga86vjAGHUcMqbZsicH4D44YFGqjeYKbhTmudhnn5KWfWJcR+ES9bumTSt+dw5VYbIybf83v3nGVuiAe30K2Jmuc58pHcTlxSbUMaevMbegAHSVUreKGVI9Rzh69kmTuVo3uFsEeAgMKIGPXSuHX0T6SY0wFXhEPk9xpFbMEs3fHicGr5KwZGGQHXZyCzD2BcWJhFCfWvTBwzL517DWLdUl7I4ac9b9DrGu1hUkt0Tr1999yumGvley4csmh5p/BiJJryCF7/igdMlBV8oXwHiWF8zfscyHfodL4xYL+jWseqE00zGfgKUvRY8kMyOtxfR0yEWP3sJjQ9AXfMjpTdCCIpulJfwAkY9pgvipjnwN4P2URX7Vfk+dvm0lAOo8QtEqupcQNeUaNv/H0jO1OHwpdUFRzUzALfJycZXI0aq0gBPNrz+4VWUF4EXXss1DJRVLBO4Z1SLNW+yxrB3uK3g9QDbkKfcsmvdGd/5LA9NuSSqXqzD5O92kn0TtDH5Ne4IuN2B8/6UqJWz5VNUVeT+ph1k24Uv9/iotAuUYfvsqosCb2BvokHpa4rIvDLTLAsmC5f1WeMsY8Ydnwf2e0cmZLXPVwQcKDE3zP8PnI91Fd+oL5Zx7+sdGa4QFs8dtV9y2hgYarchiugXf5tcIzDdDOm7FnBj8/Y64D7ZuSZCu16w7VvBEjHcuJwIf/Z/OhKKTv50JKU8a5RNcD3/7CCCrIvtxOK8F57arqMPJHtOXkD7dtns4NpRaghfCGX6OphkRNdJxzzx2KQzo39Lj4xEaWqwYD/3FRJiRap+5WGLonTpOIlN5ryMLLyL59lXSa7ZvfuAipLvm5TrmBlVt7FHvVj/BZ/PmpLUSTNg25tw+hJVpXCGOn+4EI7AH0Ph0SuVGKv8dnEM0P/mFWnSjpKNUb6mmm3ippgIjQwonVKbnhO3eDF9F7Ll0="
}
],
"journeyDuration": 135,
"originCity": "Hà Nội",
"originDateTime": "2021-07-23T05:00:00.000Z",
"originLocationCode": "HAN",
"originLocationName": "Sân bay Nội Bài"
}
],
"passportMandatory": true,
"refundable": false,
"sequenceNumber": "ibe3638861560249232",
"ticketType": "ETICKET",
"validReturnCabinClasses": null,
"validatingAirlineCode": "VN",
"validatingAirlineName": "Vietnam Airlines"
}
],
"requiredFields": null,
"returnDateTime": null,
"roundType": "ROUNDTRIP",
"totalPricedItinerary": 1
}
],
"infos": null,
"page": {
"nextPageNumber": 1,
"offset": 15,
"pageNumber": 0,
"previousPageNumber": -1,
"totalElements": 67,
"totalPage": 5
},
"success": true,
"textMessage": null
}
Get the list of tickets open for sale on a flight API
POST: /api/air-tickets/group-itinerary/{id}
Get a list of tickets available for sale on a specific flight
Paramaters
id path (String, Required)
Used to refer to the list of tickets available for sale on a flight
include-equivfare (Boolean, Optional)
Request to pay more ticketing fee information
page (Integer, Optional)
Number of pages you want to get results (eg: 0)
size (Integer, Optional)
Number of results you want to get in 1 page (eg 20)
sort (String, Optional)
Sort the results by the value of the returned property ascending or descending (eg: propertiesName,desc / propertiesName,asc)
Example
052a9f35-12eb-430b-baa0-7ea85a98e8b3?include-equivfare=false&page=0&size=20&sort=departureDate,asc
Request Body
Parameter
searchId(String, Required)
Data used to refer to search results This data is taken from the return results of airline ticket search
departureItinerary (AirItineraryInfo, Optional)
Outbound ticket information in case of getting filter-availability for return ticket
airlineCode(String, Required)
VN: Vietnam Airlines VJ: VietJet QH: Bamboo BL: Pacific Airlines…
groupId(String, Optional)
Journey identifier in the list of journeys returned by search results
fareSourceCode(String, Required)
Journey identifier information
supplierCode(String, Required)
The company code is also provided
searchId(String, Required)
Data used to refer to search results
filter (ItineraryFilter, Required)
Used to input the desired filtering and sorting criteria
cabinClassOptions(Array[String], Optional)
Information about the seat class you want to filter and sort
step(String, Required)
Information used to distinguish between departure and return 1: Departure direction 2: Return direction
flightType(String, Required)
Flight type information DOMESTIC: domestic INTERNATIONAL: international
stopOption(Array[String], Optional)
Stop Information
airlineOptions(Array[String], Optional)
Airline information
departureDateTimeOptions (Array[String], Optional)
Information about departure time starts at around or at what time Ex: departureDateTimeOptions: [“+18”, “+12-18”] +18: from 18h to 24h +12-18: from 12pm to 6pm
arrivalDateTimeReturnOptions (Array[String], Optional)
The end time information starts at what time or interval Ex: arrivalDateTimeReturnOptions: [“+18”, “+12-18”] +18: from 18h to 24h +12-18: from 12pm to 6pm
groupId(String, Required)
Itinerary identifier in the itinerary list retrieved from the search results
Example
{
"searchId": "ATD::210707::66c84a6f-fa81-4526-a2d9-2f7b7975214b",
"departureItinerary": null,
"filter": {
"stopOptions": [],
"airlineOptions": [],
"cabinClassOptions": [],
"ticketPolicyOptions": [],
"departureDateTimeOptions": [],
"arrivalDateTimeOptions": [],
"departureDateTimeReturnOptions": [],
"arrivalDateTimeReturnOptions": [],
"flightType": "DOMESTIC",
"groupId": "052a9f35-12eb-430b-baa0-7ea85a98e8b3",
"loadMore": true,
"step": "1"
}
}
Response
searchId(String, Required)
The reference code to the search for air tickets, taken from the search results for air tickets
groupPricedItineraries (Array[GroupPricedItineraryDTO], Optional)
Information about the list of journeys returned by search results
airSupplier(String, Required)
Carriers (VietnamAirline - VNA, VjetJet - VJ, BamBoo - QH, …)
aircraft (String, Optional)
Type of aircraft (Airbus A330, Boeing 787, .....)
airline(String, Optional)
Airlines (VJ, VNA, …)
airlineName(String, Optional)
Name of airline (Vietjet Air, Vietnam Airlines, Bamboo, …)
arrivalDateTime(String, Required)
Arrival date and time, using UTC/GMT+7 time zone
departureDateTime (String, Required)
Split flight time, using UTC/GMT+7 time zone
destinationLocationCode (String, Optional)
Flight end city code
destinationCountry(String, Optional)
The name of the country where the flight ended
destinationCountryCode (String, Optional)
Flight end country code
destinationCity(String, Optional)
The name of the city where the flight ends
destinationLocationName (String, Optional)
Airport name where the flight ends
flightNo(String, Optional)
Airplane number
flightNo(String, Optional)
Airplane number
flightType(String, Optional)
Type of flight domestic or international? Flight type: DOMESTIC: domestic INTERNATIONAL: international
groupId(String, Required)
Journey identifier in the list of journeys returned by search results
originCity(String, Optional)
City name at departure point
originCountry(String, Optional)
Country name at departure point
originCountryCode(String, Optional)
Country code at departure point
originLocationCode(String, Optional)
Flight departure city code
originLocationName(String, Optional)
Airport name at departure point
totalPricedItinerary (Integer, Required)
Total number of detailed journeys
pricedItineraries (Array[PricedItineraries], Required)
Itinerary details
airItineraryPricingInfo (AirItineraryPricingInfo, Required)
Detailed price information of the itinerary
adultFare (FareBreakdown, Required)
passengerFare (PassengerFare, Required)
Adult fare information
baseFare(FareInfo, required)
Basic fare information
amount (Double, Required)
Amount of money
decimalPlaces(Integer, Optional)
Decimal places rounded to
equivFare (FareInfo, Optional)
Similar to baseFare Ticketing fee information
serviceTax (FareInfo, Required)
Similar to baseFare Service fee information
totalFare (FareInfo, Required)
Similar to baseFare Total ticket price information
surcharges (Array[Surcharge], Required)
Information about surcharges per booking / per segment
passengerTypeQuantities (PassengerTypeQuantities, Optional)
Number/type of passengers
code(String, Required)
Adult/Child/Infant Identifier Includes: ADT - adult / CHD - child / INF - infant
quantity (Integer, Required)
Number of adults / children / infants
childFare(PassengerFare, Optional)
Child fare information Similar to adult fare information
infantFare (PassengerFare, Optional)
Infant fare information Similar to adult fare information
itinTotalFare (PassengerFare, Required)
Total fare information of the journey Similar to adult fare information
fareSourceCode(String, Required)
Journey identifier information Used to get ticket condition information
allowHold (Boolean, Required)
Information to allow to hold a reservation or not
cabinClassName(String, Required)
Seat class information: ECONOMY - universal seat PREMIUM - special economy seat BUSINESS - business chair
fightNo(String, Optional)
Displays aircraft number information
originDestinationOptions (Array(OriginDestinationOptions), Required)
Cruise’s blocking/stopping information
flightDirection(String, Required)
Show flight direction information of the journey D - departure direction R - return direction
journeyDuration (Integer, Required)
Show flight time
flightSegments (Array(FlightSegments), Required)
Show detailed information of departure / end points in the journey
page (AirPage, Required)
Object that describes information about pagination. Sequence number of each page returned, element of each page, total number of pages
duration(Integer, Optional),
errors (Array[Error], Optional)
infos(Array[Info], Optional)
success(Boolean, Optional)
textMessage(String, Optional)
Example
{
"duration" : 1025,
"errors" : null,
"groupPricedItinerary" : {
"airSupplier" : "VJ",
"aircraft" : "Airbus A321",
"vnaArea" : null,
"airline" : "VJ",
"airlineName" : "VietJet Air",
"arrivalDateTime" : "2021-07-23T07:20:00.000Z",
"departureDateTime" : "2021-07-23T05:10:00.000Z",
"destinationCity" : "Hồ Chí Minh",
"destinationCountry" : "Vietnam",
"destinationCountryCode" : "VN",
"destinationLocationCode" : "SGN",
"destinationLocationName" : "Sân bay Tân Sơn Nhất",
"fightNo" : "135",
"flightType" : "DOMESTIC",
"groupId" : "052a9f35-12eb-430b-baa0-7ea85a98e8b3",
"originCity" : "Hà Nội",
"originCountry" : "Vietnam",
"originCountryCode" : "VN",
"originLocationCode" : "HAN",
"originLocationName" : "Sân bay Nội Bài",
"pricedItineraries" : [ {
"airItineraryPricingInfo" : {
"adultFare" : {
"fareBasisCodes" : null,
"passengerFare" : {
"baseFare" : {
"amount" : 1319000.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"comboMarkup" : null,
"equivFare" : null,
"serviceTax" : {
"amount" : 350900.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"surcharges" : [ {
"amount" : 0.0,
"indicator" : "Ticket fee per segment",
"type" : "Ticket fee per segment"
} ],
"taxes" : null,
"totalFare" : {
"amount" : 1669900.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"totalPaxFee" : null
},
"passengerTypeQuantities" : {
"code" : "ADT",
"quantity" : 1
}
},
"childFare" : null,
"divideInPartyIndicator" : false,
"fareInfoReferences" : null,
"fareSourceCode" : "dom95053f40-3fd0-4f62-a96c-d4afa489c283",
"fareType" : "PUBLIC",
"infantFare" : null,
"itinTotalFare" : {
"baseFare" : {
"amount" : 1319000.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"comboMarkup" : null,
"equivFare" : null,
"serviceTax" : {
"amount" : 350900.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"totalFare" : {
"amount" : 1669900.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"totalPaxFee" : null,
"totalTax" : {
"amount" : 0.0,
"currencyCode" : null,
"decimalPlaces" : 2
}
}
},
"allowHold" : true,
"baggageItems" : [ {
"amount" : 0.0,
"code" : "air-tickets.baggage-items.vietnam.vj.economy.baggage.adult.free",
"direction" : null,
"fareCode" : null,
"id" : "air-tickets.baggage-items.vietnam.vj.economy.baggage.adult.free",
"name" : "7kg xách tay",
"serviceType" : "BAGGAGE"
} ],
"cabinClassName" : "ECONOMY",
"directionInd" : "DEPARTURE",
"fightNo" : "135",
"mealItems" : null,
"onlyPayLater" : false,
"originDestinationOptions" : [ {
"cabinClassName" : "ECONOMY",
"destinationCity" : "Hồ Chí Minh",
"destinationDateTime" : "2021-07-23T07:20:00.000Z",
"destinationLocationCode" : "SGN",
"destinationLocationName" : "Sân bay Tân Sơn Nhất",
"flightDirection" : "D",
"flightSegments" : [ {
"adultBaggage" : null,
"aircraft" : "Airbus A321",
"arrivalAirportLocationCode" : "SGN",
"arrivalAirportLocationName" : "Sân bay Tân Sơn Nhất",
"arrivalCity" : "Hồ Chí Minh",
"arrivalDateTime" : "2021-07-23T07:20:00.000Z",
"cabinClassCode" : "L1_ECO",
"cabinClassName" : "ECONOMY",
"cabinClassText" : "Economy",
"childBaggage" : null,
"departureAirportLocationCode" : "HAN",
"departureAirportLocationName" : "Sân bay Nội Bài",
"departureCity" : "Hà Nội",
"departureDateTime" : "2021-07-23T05:10:00.000Z",
"eticket" : true,
"fareBasicCode" : null,
"fareCode" : null,
"flightDirection" : "D",
"flightNumber" : "135",
"infantBaggage" : null,
"journeyDuration" : 130,
"marketingAirlineCode" : "VJ",
"marriageGroup" : null,
"mealCode" : null,
"operatingAirline" : {
"code" : "VJ",
"equipment" : null,
"flightNumber" : "135",
"name" : "VietJet Air"
},
"resBookDesignCode" : "L1_ECO",
"seatsRemaining" : null,
"stopQuantity" : 0,
"stopQuantityInfo" : null,
"supplierFareKey" : null,
"supplierJourneyKey" : "FE1G3mI6J96guNcAzJB8yTeBzLZRAYEOnwn9YGOFJJztƒS7kLTBSBi25njFnV5B0HNFbXtvvIQiUDfNE¥Pqx3WSriPxr9IlTddLHufsqIM0oNnapPeNa1YAcBL4BUZyzjPyb¥0vzaCP¥5Bk9LpFxJTyFThaƒJiL7Tkƒhz4a¥FVSƒXfpqmsCaQWijrGgcOExEM7¥YXajB5L1W9SjqIYUUSewƒSb7BuyBX9sYii0QbSnQ8BdSvR4f2sq3pzUPx3AdCb2hZzEbIfpSEF8q5JAvRjuANKRqQhVei1eyTI72ZPbI0lKƒvrLemkP6OyE88rTƒuvxxHDe¥6K9dKwVV4GtkXj3J3lQOMsH2HKNOmpwG5TR4L1RiOI75PJ4YkC62AHux5vvTƒ¥R8vac6V9lKlMeMFra27Bv3qYhfwSWCgGNOcFsrs2yO1W¥WWXNMvWA2jNKUJl1H65iX18UHyzANy9Vrcthtjjr6PXKZHhQPnLP¥flZA="
} ],
"journeyDuration" : 130,
"originCity" : "Hà Nội",
"originDateTime" : "2021-07-23T05:10:00.000Z",
"originLocationCode" : "HAN",
"originLocationName" : "Sân bay Nội Bài"
} ],
"passportMandatory" : true,
"refundable" : false,
"sequenceNumber" : "ibe3640395997485504",
"ticketType" : "ETICKET",
"validReturnCabinClasses" : null,
"validatingAirlineCode" : "VJ",
"validatingAirlineName" : "VietJet Air"
}, {
"airItineraryPricingInfo" : {
"adultFare" : {
"fareBasisCodes" : null,
"passengerFare" : {
"baseFare" : {
"amount" : 1499000.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"comboMarkup" : null,
"equivFare" : null,
"serviceTax" : {
"amount" : 368900.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"surcharges" : [ {
"amount" : 0.0,
"indicator" : "Ticket fee per segment",
"type" : "Ticket fee per segment"
} ],
"taxes" : null,
"totalFare" : {
"amount" : 1867900.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"totalPaxFee" : null
},
"passengerTypeQuantities" : {
"code" : "ADT",
"quantity" : 1
}
},
"childFare" : null,
"divideInPartyIndicator" : false,
"fareInfoReferences" : null,
"fareSourceCode" : "domb8304899-04b8-4ff4-9262-9ad713608507",
"fareType" : "PUBLIC",
"infantFare" : null,
"itinTotalFare" : {
"baseFare" : {
"amount" : 1499000.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"comboMarkup" : null,
"equivFare" : null,
"serviceTax" : {
"amount" : 368900.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"totalFare" : {
"amount" : 1867900.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"totalPaxFee" : null,
"totalTax" : {
"amount" : 0.0,
"currencyCode" : null,
"decimalPlaces" : 2
}
}
},
"allowHold" : true,
"baggageItems" : [ {
"amount" : 0.0,
"code" : "air-tickets.baggage-items.vietnam.vj.premium.baggage.adult.free",
"direction" : null,
"fareCode" : null,
"id" : "air-tickets.baggage-items.vietnam.vj.premium.baggage.adult.free",
"name" : "7kg xách tay + 20kg ký gửi",
"serviceType" : "BAGGAGE"
} ],
"cabinClassName" : "PREMIUM",
"directionInd" : "DEPARTURE",
"fightNo" : "135",
"mealItems" : null,
"onlyPayLater" : false,
"originDestinationOptions" : [ {
"cabinClassName" : "PREMIUM",
"destinationCity" : "Hồ Chí Minh",
"destinationDateTime" : "2021-07-23T07:20:00.000Z",
"destinationLocationCode" : "SGN",
"destinationLocationName" : "Sân bay Tân Sơn Nhất",
"flightDirection" : "D",
"flightSegments" : [ {
"adultBaggage" : null,
"aircraft" : "Airbus A321",
"arrivalAirportLocationCode" : "SGN",
"arrivalAirportLocationName" : "Sân bay Tân Sơn Nhất",
"arrivalCity" : "Hồ Chí Minh",
"arrivalDateTime" : "2021-07-23T07:20:00.000Z",
"cabinClassCode" : "B1_DLX",
"cabinClassName" : "PREMIUM",
"cabinClassText" : "Premium",
"childBaggage" : null,
"departureAirportLocationCode" : "HAN",
"departureAirportLocationName" : "Sân bay Nội Bài",
"departureCity" : "Hà Nội",
"departureDateTime" : "2021-07-23T05:10:00.000Z",
"eticket" : true,
"fareBasicCode" : null,
"fareCode" : null,
"flightDirection" : "D",
"flightNumber" : "135",
"infantBaggage" : null,
"journeyDuration" : 130,
"marketingAirlineCode" : "VJ",
"marriageGroup" : null,
"mealCode" : null,
"operatingAirline" : {
"code" : "VJ",
"equipment" : null,
"flightNumber" : "135",
"name" : "VietJet Air"
},
"resBookDesignCode" : "B1_DLX",
"seatsRemaining" : null,
"stopQuantity" : 0,
"stopQuantityInfo" : null,
"supplierFareKey" : null,
"supplierJourneyKey" : "FE1G3mI6J96guNcAzJB8ySG7yJpj7V0vJxur9hB00jyNcwƒ20DdiB6fj9ƒvf9GgUPS3rI8a¥ƒYn83OMqVXPoZwCp649T3OB0aQ7ItYXABxYRfM6ZiDbfC62m¥¥yAZf5jf7NBG6IJSBVQnsJZWUMvrv6CtZ9j1N5OQ5sUtFN37WkEjJEfSORxmB2ZQdKamFtKHi¥dgP¥7EYIHXmy1f6hdavIhehIqx9Kl¥0gPaxg2ycItGrM0ZkRcUFypKbAlYoUw8DaNiLc3Q3XcNkHy0LJlg4QzLcoWk6uwDkBMr3KUnCxyBR1beBxMhopJovzMvnRZWaWuTMfz¥7dhh32SnQ9OzYwz0uZ¥FreZDsZLp1kzrXPZDcmzsxpvfVaclBhMlJPxz¥ByUpAMUKCQyhfbDINrCiqXDKG5aFEXYs5AFl2SyTl12¥ghZJ8nfkZve9QoEA0EEfsSomUdKcaNƒrCH1H1Esj8jVUthM3fCppoSJPGjOjI="
} ],
"journeyDuration" : 130,
"originCity" : "Hà Nội",
"originDateTime" : "2021-07-23T05:10:00.000Z",
"originLocationCode" : "HAN",
"originLocationName" : "Sân bay Nội Bài"
} ],
"passportMandatory" : true,
"refundable" : false,
"sequenceNumber" : "ibe3640395997554532",
"ticketType" : "ETICKET",
"validReturnCabinClasses" : null,
"validatingAirlineCode" : "VJ",
"validatingAirlineName" : "VietJet Air"
}, {
"airItineraryPricingInfo" : {
"adultFare" : {
"fareBasisCodes" : null,
"passengerFare" : {
"baseFare" : {
"amount" : 3200000.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"comboMarkup" : null,
"equivFare" : null,
"serviceTax" : {
"amount" : 539000.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"surcharges" : [ {
"amount" : 0.0,
"indicator" : "Ticket fee per segment",
"type" : "Ticket fee per segment"
} ],
"taxes" : null,
"totalFare" : {
"amount" : 3739000.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"totalPaxFee" : null
},
"passengerTypeQuantities" : {
"code" : "ADT",
"quantity" : 1
}
},
"childFare" : null,
"divideInPartyIndicator" : false,
"fareInfoReferences" : null,
"fareSourceCode" : "dom1c7a82fb-83f9-4fe0-9451-bb023179deaa",
"fareType" : "PUBLIC",
"infantFare" : null,
"itinTotalFare" : {
"baseFare" : {
"amount" : 3200000.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"comboMarkup" : null,
"equivFare" : null,
"serviceTax" : {
"amount" : 539000.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"totalFare" : {
"amount" : 3739000.0,
"currencyCode" : null,
"decimalPlaces" : 2
},
"totalPaxFee" : null,
"totalTax" : {
"amount" : 0.0,
"currencyCode" : null,
"decimalPlaces" : 2
}
}
},
"allowHold" : true,
"baggageItems" : [ {
"amount" : 0.0,
"code" : "air-tickets.baggage-items.vietnam.vj.business.baggage.adult.free",
"direction" : null,
"fareCode" : null,
"id" : "air-tickets.baggage-items.vietnam.vj.business.baggage.adult.free",
"name" : "10kg xách tay + 30kg ký gửi",
"serviceType" : "BAGGAGE"
} ],
"cabinClassName" : "BUSINESS",
"directionInd" : "DEPARTURE",
"fightNo" : "135",
"mealItems" : null,
"onlyPayLater" : false,
"originDestinationOptions" : [ {
"cabinClassName" : "BUSINESS",
"destinationCity" : "Hồ Chí Minh",
"destinationDateTime" : "2021-07-23T07:20:00.000Z",
"destinationLocationCode" : "SGN",
"destinationLocationName" : "Sân bay Tân Sơn Nhất",
"flightDirection" : "D",
"flightSegments" : [ {
"adultBaggage" : null,
"aircraft" : "Airbus A321",
"arrivalAirportLocationCode" : "SGN",
"arrivalAirportLocationName" : "Sân bay Tân Sơn Nhất",
"arrivalCity" : "Hồ Chí Minh",
"arrivalDateTime" : "2021-07-23T07:20:00.000Z",
"cabinClassCode" : "V_SBoss",
"cabinClassName" : "BUSINESS",
"cabinClassText" : "SkyBoss",
"childBaggage" : null,
"departureAirportLocationCode" : "HAN",
"departureAirportLocationName" : "Sân bay Nội Bài",
"departureCity" : "Hà Nội",
"departureDateTime" : "2021-07-23T05:10:00.000Z",
"eticket" : true,
"fareBasicCode" : null,
"fareCode" : null,
"flightDirection" : "D",
"flightNumber" : "135",
"infantBaggage" : null,
"journeyDuration" : 130,
"marketingAirlineCode" : "VJ",
"marriageGroup" : null,
"mealCode" : null,
"operatingAirline" : {
"code" : "VJ",
"equipment" : null,
"flightNumber" : "135",
"name" : "VietJet Air"
},
"resBookDesignCode" : "V_SBoss",
"seatsRemaining" : null,
"stopQuantity" : 0,
"stopQuantityInfo" : null,
"supplierFareKey" : null,
"supplierJourneyKey" : "FE1G3mI6J96guNcAzJB8yZ¥FGw7p5Weqh1jFldOtANHbBsM1ZM4xm9eJCMdqbmYTODQA1GPi0yHK6bYrz1U6SPAnrzCjhNqS6fuU9vMGIlpY3BwX937d9zbpx5aotYD2Hkad7SVACsbXLfkhQm2Bu0X¥k9ƒAQbtCjpXj6rFƒKBXVZSRY4hOF8GQQZ2IFqdegJGFHN6kEeNGHYeJt39SUgpDDRMq0OtLvm0iic¥1YGj1AJVIaj6FUƒxPo4OkVIUB83axadxG7pbDxZCn28¥85bUM50I2Bcp4yxrKnHC7YkXWAKN5JhIQzRHTrt1HbQzF9MP3FP7PWoNvG0BHUndiYelƒ653zOv0dSzƒSX2Tzomz11Rf2fHWHPXwigUvBA74Zsy5vKwDNZxYYv9aJC3c33pEƒ6LsD5NDmdiSRtXzrl8tzStLzyjYapGU0fDSh9bThcZCxpeejWyEVyjHdgqV4e77ncQTeUWUKNa1ggƒrerpRc="
} ],
"journeyDuration" : 130,
"originCity" : "Hà Nội",
"originDateTime" : "2021-07-23T05:10:00.000Z",
"originLocationCode" : "HAN",
"originLocationName" : "Sân bay Nội Bài"
} ],
"passportMandatory" : true,
"refundable" : false,
"sequenceNumber" : "ibe3640395997606506",
"ticketType" : "ETICKET",
"validReturnCabinClasses" : null,
"validatingAirlineCode" : "VJ",
"validatingAirlineName" : "VietJet Air"
} ],
"requiredFields" : null,
"returnDateTime" : null,
"roundType" : "ROUNDTRIP",
"totalPricedItinerary" : 3
},
"infos" : null,
"searchId" : "ATD::210707::66c84a6f-fa81-4526-a2d9-2f7b7975214b",
"success" : true,
"textMessage" : null
}
Get flight ticket condition API
POST: /api/air-tickets/farerules
Get the ticket conditions of the flight
Paramaters
language (Boolean, Optional)
The language you want to get
Example
?language=vi
Request Body
searchId(String, Required)
Data used to refer to search results This data is taken from the return results of airline ticket search
groupId(String, Required)
Journey identifier in the list of journeys returned by search results
fareSourceCode(String, Required)
Journey identifier information
Example
{
"fareSourceCode": "dom07b2da7b-3232-4294-9278-b35fb6307714",
"groupId": "27b091a7-62b8-4ce2-b45b-eda3340d7673",
"searchId": "ATD::210720::dc96e1a9-c39e-4f48-974e-e0be6abb45c7"
}
Response
fareRules(Array[FareRules], Required)
Return ticket conditions list
arrivalAirportLocationCode (String, Required)
Destination location code
departureAirportLocationCode (String, Required)
Departure location code
departureDateTime(String, Required)
Departure time Identified by yyyy-MM-dd’T’Z’
arrivalDateTime(String, Required)
Arrival time Format in yyyy-MM-dd’T’HHon’
fareRuleItems (Array[FareRuleItem], Required)
Detailed list of ticket conditions
detail(String, Required)
Detailed information about ticket conditions HTML format
title(String, Required)
Information about the conditions of the return ticket / the condition of the return ticket
duration(Integer, Optional),
errors (Array[Error], Optional),
infos(Array[Info], Optional),
success(Boolean, Optional),
textMessage(String, Optional)
Example
{
"duration": 1444,
"errors": null,
"fareRules": [
{
"arrivalAirportLocationCode": "SGN",
"arrivalAirportLocationName": null,
"arrivalCity": null,
"arrivalDateTime": "2021-08-16T07:55:00.000Z",
"departureAirportLocationCode": "HAN",
"departureAirportLocationName": null,
"departureCity": null,
"departureDateTime": "2021-08-16T05:45:00.000Z",
"fareRuleItems": [
{
"detail": "\n \n <br /><strong>- Hạng đặt chỗ:</strong> Economy Saver\n <br /><strong>- Thay đổi:</strong> Trước 3h tính từ giờ khởi hành từng chặng bay : 270.000 VND . Trong/sau 3h tính từ giờ khởi hành từng chặng bay: Không áp dụng\n <br /><strong>- Hoàn/hủy vé:</strong> Không áp dụng\n <br /><strong>- Đổi tên:</strong> Chỉ áp dụng đối với vé chưa sử dụng. Thay đổi trước giờ khởi hành 3h của chuyến bay đầu tiên và phải đổi tên cho cả hành trình, thu phí thay đổi tên 350.000 VND\n <br /><strong>- Hành lý:</strong> Xách tay 7kg + Ký gửi 20kg\n <br /><strong>- Suất ăn:</strong> Đã bao gồm\n <br /><strong>- Hệ số cộng điểm Bamboo Club:</strong> 0.25\n\t <br /><strong>- Ghi chú:</strong> Mọi thay đổi trên vé phải thực hiện trước 3h so với giờ khởi hành hoặc theo quy định của từng loại vé. Tất cả phí áp dụng chưa bao gồm VAT và được tính cho từng khách/chặng + chênh lệch vé (nếu có). Tết Nguyên Đán 2022: 17/01/2022 – 16/02/2022\n\t\t <br /><strong>- Ghi chú Covid-19:</strong> HÀNH KHÁCH KHI ĐẶT CHỖ MUA VÉ CẦN THỰC HIỆN KHAI BÁO Y TẾ ĐIỆN TỬ BẮT BUỘC TRƯỚC KHI TỚI SÂN BAY\n <br /><br/><strong> Tham khảo thêm <a href='https://www.bambooairways.com/vn-vi/thong-tin-dat-ve/dat-chuyen-bay/cac-hang-ve-gia-ve/' target='_blank'>Điều kiện giá vé áp dụng cho các vé xuất và khởi hành từ ngày 01/03/2021</a>\n\t\t\t\n ",
"title": "Điều kiện chiều đi"
}
],
"operatingAirline": {
"code": "VN",
"equipment": null,
"flightNumber": null,
"name": null
}
}
],
"fareSourceCode": null,
"groupId": null,
"infos": null,
"searchId": null,
"success": true,
"textMessage": null
}
Last updated