Datacom | Hướng dẫn tích hợp API

Search flight

This feature allows searching for flights and fares by specified date and itinerary.

Overview

Request URL:	https://ibe.datacom.vn/api/flight/searchflight
Method:	POST
Data type:	JSON
API Specification:	See specifications

Applicable system

System code	System name
VN	Vietnam Airlines
VJ	Vietjet Air
QH	Bamboo Airways
VU	Vietravel Airlines
9G	Sun Phu Quoc Airways
1G	Galileo
1A	Amadeus
1B	Abacus
FO	Flyone
AK	AirAsia
TR	Scoot

Request

{
    "RequestInfo": {
        "PrivateKey": "{{PrivateKey}}",
        "ApiAccount": "{{ApiAccount}}",
        "ApiPassword": "{{ApiPassword}}",
        "Currency": "{{Currency}}",
        "Language": "{{Language}}",
        "IpAddress": "{{IpAddress}}"
    },
    "System": "string",
    "Adt": 0,
    "Chd": 0,
    "Inf": 0,
    "Tourcode": "string",
    "ListRoute": [
        {
            "Leg": 0,
            "StartPoint": "string",
            "EndPoint": "string",
            "DepartDate": "string"
        }
    ],
    "Option": {
        "DirectOnly": true,
        "NearByAirport": true, 
        "PreferCabin": "string", 
        "NdcOnly": true, 
        "CombineMode": "string" 
    }
}

Data specification

Information field	Describe	Data type	Obligatory	For example
RequestInfo	Query information See description Shared properties	object	Yes
System	Reservation system	string	Yes	VN
Adt	Number of adult guests	int	Yes	1
Chd	Number of children guests	int	Yes	0
Inf	Number of infant guests	int	Yes	0
TourCode	Airline discount codes	string	Yes
ListRoute	Flights you want to search for	list	Yes
Leg	Flight order	int	Yes	0
StartPoint	Airport code, departure city	string	Yes	HAN
EndPoint	Airport code, destination city	string	Yes	SGN
DepartDate	Departure date Format ddMMyyyy	string	Yes	12032025
Option	Search options	object	No
DirectOnly	Find direct flights only	bool	No	true
NearByAirport	Includes airports near the destination	bool	No	true
PreferCabin	Recommended seat class Value: economy, premium, business	string	No
NdcOnly	Get results only Ndc	bool	Yes
CombineMode	Matchmaking mode Value: flight, fare	string	Yes

Response

{
  "StatusCode": "string",
  "Success": true,
  "Message": "string",
  "Language": "string",
  "RequestID": 0,
  "Session": "string",
  "ListGroup": [
    {
      "Leg": 0,
      "TripType": "string",
      "Journey": "string",
      "StartPoint": "string",
      "EndPoint": "string",
      "DepartDate": "string",
      "ListAirOption": [
        {
          "OptionId": 0,
          "Leg": 0,
          "Itinerary": 0,
          "Airline": "string",
          "System": "string",
          "Source": "string",
          "Remark": "string",
          "ListFlightOption": [
            {
              "OptionId": 0,
              "ListFlight": [
                {
                  "Leg": 0,
                  "FlightId": "string",
                  "Airline": "string",
                  "Operator": "string",
                  "StartPoint": "string",
                  "EndPoint": "string",
                  "StartDate": "2024-11-27T06:59:27.418Z",
                  "EndDate": "2024-11-27T06:59:27.418Z",
                  "DepartDate": "string",
                  "ArriveDate": "string",
                  "FlightNumber": "string",
                  "StopNum": 0,
                  "Duration": 0,
                  "ListSegment": [
                    {
                      "Leg": 0,
                      "SegmentId": "string",
                      "Airline": "string",
                      "Operator": "string",
                      "StartPoint": "string",
                      "EndPoint": "string",
                      "StartDate": "2024-11-27T06:59:27.418Z",
                      "EndDate": "2024-11-27T06:59:27.418Z",
                      "DepartDate": "string",
                      "ArriveDate": "string",
                      "StartTerminal": "string",
                      "EndTerminal": "string",
                      "FlightNumber": "string",
                      "Equipment": "string",
                      "FareClass": "string",
                      "FareBasis": "string",
                      "Duration": 0,
                      "HasStop": true,
                      "StopPoint": "string",
                      "StopTime": 0,
                      "TechnicalStop": "string",
                      "MarriageGrp": "string",
                      "FlightsMiles": 0,
                      "Status": "string"
                    }
                  ]
                }
              ]
            }
          ],
          "ListFareOption": [
            {
              "OptionId": 0,
              "FareClass": "string",
              "FareBasis": "string",
              "FareFamily": "string",
              "CabinCode": "string",
              "CabinName": "string",
              "Refundable": true,
              "Availability": 0,
              "Unavailable": true,
              "ExpiryDate": "string",
              "BaseFare": 0,
              "BaseFareOrigin": 0,
              "PriceAdt": 0,
              "PriceAdtOrigin": 0,
              "NetFare": 0,
              "NetFareOrigin": 0,
              "TotalFare": 0,
              "TotalFareOrigin": 0,
              "Currency": "string",
              "Airline": "string",
              "System": "string",
              "Source": "string",
              "Tourcode": "string",
              "ListFarePax": [
                {
                  "PaxType": "string",
                  "PaxNumb": 0,
                  "BaseFare": 0,
                  "BaseFareOrigin": 0,
                  "NetFare": 0,
                  "NetFareOrigin": 0,
                  "TotalFare": 0,
                  "TotalFareOrigin": 0,
                  "ListFareItem": [
                    {
                      "Code": "string",
                      "Amount": 0,
                      "Name": "string"
                    }
                  ],
                  "ListTaxDetail": [
                    {
                      "Code": "string",
                      "Amount": 0,
                      "Name": "string"
                    }
                  ],
                  "ListFareInfo": [
                    {
                      "SegmentId": "string",
                      "StartPoint": "string",
                      "EndPoint": "string",
                      "FareClass": "string",
                      "FareBasis": "string",
                      "HandBaggage": "string",
                      "FreeBaggage": "string",
                      "Availability": 0
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Data specification

Information field	Describe	Data type	For example
StatusCode	Status code	string	0000
Success	Return status	boolean	true
Message	Error message returned	string
Language	Return language	string	Vi
RequestId	Request ID	int
Session	Session	string
ListGroup	Flight group list	object
Leg	Leg	int
TripType	Trip type	string
StartPoint	Airport code, departure city	string	HAN
EndPoint	Airport code, destination city	string	SGN
DepartDate	Departure date Format ddMMyyyy	string	12032025
ListAirOption	Flight options list	object
Leg	Leg	int
Itinerary	Itinerary	int
Airline	Airline	string	VN
System	System	string	1G
Source	Source	string	API
Remark	Remark	string
ListFlightOption	Flight options list	object
OptionId	Option ID	int
ListFlight	List Flight	object
Leg	Leg	int	0
FlightId	Flight ID	string	123456
Airline	Airline code	string	VN
Operator	Carrier code	string	VN
StartPoint	Departure airport code	string	HAN
EndPoint	Destination airport code	string	SGN
StartDate	Start date Format ddMMyyyy	string	12032025
EndDate	End date Format ddMMyyyy	string	12102025
DepartDate	Departure date Format ddMMyyyy	string	12032025
ArriveDate	Arrive Date Format ddMMyyyy	string	12102025
FlightNumber	Flight number	string	VN205
StopNum	Number of stops	int	0
Duration	Duration	int	0
ListSegment	Flight list	list
Leg	Leg	int	0
SegmentId	Flight itinerary ID	string	123456
Airline	Airline code	string	VJ
Operator	Carrier code	string	VN
StartPoint	Departure airport code	string	HAN
EndPoint	Destination airport code	string	SGN
StartDate	Start Date Format ddMMyyyy	string	11122024
EndDate	End Date Format ddMMyyyy	string	01012025
DepartDate	Departure date Format ddMMyyyy	datetime	11122024
ArriveDate	Arrive Date Format ddMMyyyy	datetime	12122024
StartTerminal	Departure terminal	string	1
EndTerminal	Landing terminal	string	1
FlightNumber	Flight number	string	VN205
Equipment	Aircraft type code	string	Airbus A321
FareClass	Fare Class	string	H
FareBasis	Fare Basis	string	First Class
Duration	Duration	int	120
HasStop	Has Stop	boolean	True/false
StopPoint	Stop Point	string
StopTime	Stop Time	double
TechnicalStop	Airport code technical stop	string
MarriageGrp	The group is married	string
FlightsMiles	Air miles	int
Status	Status	string
ListFareOption	List of fare options	object
OptionId	Option ID	int	0
FareClass	Fare Class	string	H
FareBasis	Fare Basis	string	First Class
FareFamily	Price group	string
CabinCode	Cabin Code	string
CabinName	Cabin Name	string
Refundable	Refundable	boolean	True/false
Availability	Availability	int	9
Unavailable	Unavailable	boolean	True/false
ExpiryDate	ExpiryDate	string	120
BaseFare	Basic fare for an adult	double	0
BaseFareOrigin	Base fare for an adult without airline discount code	double	0
PriceAdt	Ticket price for one adult	double	0
PriceAdtOrigin	Price per adult ticket without airline discount code	double	0
NetFare	Net fare	double	0
NetFareOrigin	Net fare before applying the company's discount code	double	0
TotalFare	Total fare	double	0
TotalFareOrigin	Total fare before applying airline discount code	double	0
Currency	Currency	string	VND
Airline	Airline	string	VN
System	System	string	VN
Source	Source	string
Tourcode	Tourcode	string
ListFarePax	List of ticket price information for each customer	list
PaxType	Target audience	string
PaxNumb	Number of guests	int
BaseFare	Base fare	double
BaseFareOrigin	Basic fare without airline discount code applied	double
NetFare	Net fare	double
NetFareOrigin	Net fare before applying the company's discount code	double
TotalFare	Total fare	double
TotalFareOrigin	Total fare before applying airline discount code	double
ListFareItem	List of detailed ticket price information
Code	Code	string
Amount	Amount	double
Name	Name	String
ListTaxDetail	List of tax details
Code	Code	string
Amount	Amount	double
Name	Name	string
ListFareInfo	List of detailed fare class information
SegmentId	Segmen ID	int
StartPoint	Airport code, departure city	string	HAN
EndPoint	Airport code, destination city	string	SGN
FareClass	Fare class	string
FareBasis	Fare basis	string
HandBaggage	Free carry-on baggage	string
FreeBaggage	Free checked baggage	string
Availability	Availability	int

Error code

Error code	Interpretation
0000	Success
0001	System error
0002	Flight not found

Illustration

Domestic flight search results

International flight search results

Professional B2B system, indispensable tool for F1 agents

Data source is aggregated from 11 global carrier and GDS systems.

Many rich website templates for you to choose

Easy to intergrate into any of your website

Multi-platform software development

Comprehensive solution for airlines

Perfect solution to enhance competitive ability in the market

Strategic partner in the digital transformation journey

Ensure fast and safe data processing speed

Hướng dẫn tích hợp API

Search flight

This feature allows searching for flights and fares by specified date and itinerary.

Overview

Applicable system

Request

Data specification

Response

Data specification

Error code

Illustration