Flights Search
Returns a list of flights content for the requested dates. Use this API to retrieve all the flights available based on your search criteria.
Parameters
Name
Description
Accept
string
( header )
Must be application/json
Accept - Encoding
string
( header )
Must be gzip
Authorization
string
( header )
Must be Your PID
Must be Your API Key
Customer-Ip
string
( header )
Must be IP address of the customer, as captured by your integration. Send IPV4 addresses only.
Ensure your integration passes the customer’s IP, not your own. This value helps determine their location and other settings.
Also used for fraud recovery and other important analytics.
ModeType
string
( query )
Must be either "Test" or "LIVE"
Your application must be approved from Adivaha Personnel. All the transactions will be treated as LIVE once the parameter is set to LIVE.
action
string
( query )
Must be "flightSearch" as parameter
Action methods in Web API controller can have one or more parameters of different types. It can be either primitive type or complex type. Web API binds action method parameters either with URL's query string or with request body depending on the parameter type.
Definition and request parameters for flight search
From_IATACODE
string
( query )
IATA code of Departure Airport ie. "DEL"
To_IATACODE
string
( query )
IATA code of Arrival Airport ie. "GOI"
Flights_City_From
string
( query )
Country the customer is flying from
Flights_City_to
string
( query )
Country the customer is flying to
departure_date
string
( query )
The date by which a guest must depart. Must follow YYYY-MM-DD format.
return_date
string
( query )
The date by which a guest must return. Must follow YYYY-MM-DD format.
adults
number
( query )
Number of adults to be set for the search.
children
number
( query )
Number of children to be set for the search.
infants
number
( query )
Number of infants to be set for the search.
Flights_category
string
( query )
Type of flight to be set for the search. (ie, Economy/PremiumEconomy/Business/PremiumBusiness/First/All)
isoneway
string
( query )
Type of flight to be set for oneway or return. (ie, Yes or No)
REQUEST
API Endpoint: https://your-end-point/api/v1/travel-api/flights/
header: array(
'Content-Type:application/json',
'Accept-encoding: gzip',
'PID:'ADD-YOUR-KEY',
'x-api-key:'ADD-YOUR-KEY'
);
POST:
{
"action": "flightSearch",
"adults": "1",
"children": "0",
"infants": "0",
"isoneway": "Yes",
"From_IATACODE": "DEL",
"To_IATACODE": "JAI",
"Flights_City_From": "India",
"Flights_City_to": "India",
"departure_date": "2021-09-09",
"return_date": "2021-09-10",
"Flights_category": "Economy"
}
Response
The API returns an HTTP response, which generally includes the result of the request invocation
{
"status": "200",
"status_message": "OK",
"responseData": {
"Response": {
"ResponseStatus": 1,
"Error": {
"ErrorCode": 0,
"ErrorMessage": ""
},
"TraceId": "a5869df9-591e-43c4-ac38-4cc3dbe2d8b8",
"Origin": "DEL",
"Destination": "JAI",
"Results": [
[
{
"IsHoldAllowedWithSSR": false,
"ResultIndex": "OB1",
"Source": 5,
"IsLCC": false,
"IsRefundable": true,
"IsPanRequiredAtBook": false,
"IsPanRequiredAtTicket": false,
"IsPassportRequiredAtBook": false,
"IsPassportRequiredAtTicket": false,
"GSTAllowed": true,
"IsCouponAppilcable": true,
"IsGSTMandatory": false,
"AirlineRemark": "CORPORATE FARE.",
"ResultFareType": "RegularFare",
"Fare": {
"Currency": "INR",
"BaseFare": 1000,
"Tax": 703,
"TaxBreakup": [
{
"key": "K3",
"value": 63
},
{
"key": "YQTax",
"value": 0
},
{
"key": "YR",
"value": 250
},
{
"key": "PSF",
"value": 0
},
{
"key": "UDF",
"value": 0
},
{
"key": "INTax",
"value": 0
},
{
"key": "TransactionFee",
"value": 0
},
{
"key": "OtherTaxes",
"value": 390
}
],
"YQTax": 0,
"AdditionalTxnFeeOfrd": 0,
"AdditionalTxnFeePub": 0,
"PGCharge": 0,
"OtherCharges": 0,
"ChargeBU": [
{
"key": "TBOMARKUP",
"value": 0
},
{
"key": "GLOBALPROCUREMENTCHARGE",
"value": 0
},
{
"key": "CONVENIENCECHARGE",
"value": 0
},
{
"key": "OTHERCHARGE",
"value": 0
}
],
"Discount": 0,
"PublishedFare": 1703,
"CommissionEarned": 8.81,
"PLBEarned": 0,
"IncentiveEarned": 0,
"OfferedFare": 1694.19,
"TdsOnCommission": 3.52,
"TdsOnPLB": 0,
"TdsOnIncentive": 0,
"ServiceFee": 0,
"TotalBaggageCharges": 0,
"TotalMealCharges": 0,
"TotalSeatCharges": 0,
"TotalSpecialServiceCharges": 0
},
"FareBreakdown": [
{
"Currency": "INR",
"PassengerType": 1,
"PassengerCount": 1,
"BaseFare": 1000,
"Tax": 703,
"TaxBreakUp": [
{
"key": "K3",
"value": 63
},
{
"key": "YR",
"value": 250
},
{
"key": "OtherTaxes",
"value": 390
}
],
"YQTax": 0,
"AdditionalTxnFeeOfrd": 0,
"AdditionalTxnFeePub": 0,
"PGCharge": 0,
"SupplierReissueCharges": 0
}
],
"Segments": [
[
{
"Baggage": "15 KG",
"CabinBaggage": null,
"CabinClass": 2,
"TripIndicator": 1,
"SegmentIndicator": 1,
"Airline": {
"AirlineCode": "AI",
"AirlineName": "Air India",
"FlightNumber": "9843",
"FareClass": "E",
"OperatingCarrier": "9I-843"
},
"NoOfSeatAvailable": 6,
"Origin": {
"Airport": {
"AirportCode": "DEL",
"AirportName": "Indira Gandhi Airport",
"Terminal": "3",
"CityCode": "DEL",
"CityName": "Delhi",
"CountryCode": "IN",
"CountryName": "India"
},
"DepTime": "2021-09-09T07:15:00"
},
"Destination": {
"Airport": {
"AirportCode": "JAI",
"AirportName": "Jaipur",
"Terminal": "2",
"CityCode": "JAI",
"CityName": "Jaipur",
"CountryCode": "IN",
"CountryName": "India"
},
"ArrTime": "2021-09-09T08:15:00"
},
"Duration": 60,
"GroundTime": 0,
"Mile": 0,
"StopOver": false,
"FlightInfoIndex": "",
"StopPoint": "",
"StopPointArrivalTime": "0001-01-01T00:00:00",
"StopPointDepartureTime": "0001-01-01T00:00:00",
"Craft": "ATR",
"Remark": null,
"IsETicketEligible": true,
"FlightStatus": "Confirmed",
"Status": ""
}
]
],
"LastTicketDate": "2021-09-09T23:59:00.000",
"TicketAdvisory": null,
"FareRules": [
{
"Origin": "DEL",
"Destination": "JAI",
"Airline": "AI",
"FareBasisCode": "EIP9I",
"FareRuleDetail": "",
"FareRestriction": "",
"FareFamilyCode": "",
"FareRuleIndex": ""
}
],
"PenaltyCharges": {
"ReissueCharge": "3000 INR",
"CancellationCharge": "3000 INR"
},
"AirlineCode": "AI",
"ValidatingAirline": "AI"
},
{
"IsHoldAllowedWithSSR": false,
"ResultIndex": "OB2",
"Source": 5,
"IsLCC": false,
"IsRefundable": true,
"IsPanRequiredAtBook": false,
"IsPanRequiredAtTicket": false,
"IsPassportRequiredAtBook": false,
"IsPassportRequiredAtTicket": false,
"GSTAllowed": true,
"IsCouponAppilcable": true,
"IsGSTMandatory": false,
"AirlineRemark": "CORPORATE FARE.",
"ResultFareType": "RegularFare",
"Fare": {
"Currency": "INR",
"BaseFare": 1270,
"Tax": 632,
"TaxBreakup": [
{
"key": "K3",
"value": 72
},
{
"key": "YQTax",
"value": 0
},
{
"key": "YR",
"value": 170
},
{
"key": "PSF",
"value": 0
},
{
"key": "UDF",
"value": 0
},
{
"key": "INTax",
"value": 0
},
{
"key": "TransactionFee",
"value": 0
},
{
"key": "OtherTaxes",
"value": 390
}
],
"YQTax": 0,
"AdditionalTxnFeeOfrd": 0,
"AdditionalTxnFeePub": 0,
"PGCharge": 0,
"OtherCharges": 0,
"ChargeBU": [
{
"key": "TBOMARKUP",
"value": 0
},
{
"key": "GLOBALPROCUREMENTCHARGE",
"value": 0
},
{
"key": "CONVENIENCECHARGE",
"value": 0
},
{
"key": "OTHERCHARGE",
"value": 0
}
],
"Discount": 0,
"PublishedFare": 1902,
"CommissionEarned": 11.19,
"PLBEarned": 0,
"IncentiveEarned": 0,
"OfferedFare": 1890.81,
"TdsOnCommission": 4.48,
"TdsOnPLB": 0,
"TdsOnIncentive": 0,
"ServiceFee": 0,
"TotalBaggageCharges": 0,
"TotalMealCharges": 0,
"TotalSeatCharges": 0,
"TotalSpecialServiceCharges": 0
},
"FareBreakdown": [
{
"Currency": "INR",
"PassengerType": 1,
"PassengerCount": 1,
"BaseFare": 1270,
"Tax": 632,
"TaxBreakUp": [
{
"key": "K3",
"value": 72
},
{
"key": "YR",
"value": 170
},
{
"key": "OtherTaxes",
"value": 390
}
],
"YQTax": 0,
"AdditionalTxnFeeOfrd": 0,
"AdditionalTxnFeePub": 0,
"PGCharge": 0,
"SupplierReissueCharges": 0
}
],
"Segments": [
[
{
"Baggage": "25 KG",
"CabinBaggage": null,
"CabinClass": 2,
"TripIndicator": 1,
"SegmentIndicator": 1,
"Airline": {
"AirlineCode": "AI",
"AirlineName": "Air India",
"FlightNumber": "491",
"FareClass": "S",
"OperatingCarrier": ""
},
"NoOfSeatAvailable": 9,
"Origin": {
"Airport": {
"AirportCode": "DEL",
"AirportName": "Indira Gandhi Airport",
"Terminal": "3",
"CityCode": "DEL",
"CityName": "Delhi",
"CountryCode": "IN",
"CountryName": "India"
},
"DepTime": "2021-09-09T12:00:00"
},
"Destination": {
"Airport": {
"AirportCode": "JAI",
"AirportName": "Jaipur",
"Terminal": "2",
"CityCode": "JAI",
"CityName": "Jaipur",
"CountryCode": "IN",
"CountryName": "India"
},
"ArrTime": "2021-09-09T12:55:00"
},
"Duration": 55,
"GroundTime": 0,
"Mile": 0,
"StopOver": false,
"FlightInfoIndex": "",
"StopPoint": "",
"StopPointArrivalTime": "0001-01-01T00:00:00",
"StopPointDepartureTime": "0001-01-01T00:00:00",
"Craft": "321",
"Remark": null,
"IsETicketEligible": true,
"FlightStatus": "Confirmed",
"Status": ""
}
]
],
"LastTicketDate": "2021-08-25T23:59:00.000",
"TicketAdvisory": null,
"FareRules": [
{
"Origin": "DEL",
"Destination": "JAI",
"Airline": "AI",
"FareBasisCode": "SAP15",
"FareRuleDetail": "",
"FareRestriction": "",
"FareFamilyCode": "",
"FareRuleIndex": ""
}
],
"PenaltyCharges": {
"ReissueCharge": "3000 INR",
"CancellationCharge": "3500 INR"
},
"AirlineCode": "AI",
"ValidatingAirline": "AI"
},
{
"IsHoldAllowedWithSSR": false,
"ResultIndex": "OB3",
"Source": 5,
"IsLCC": false,
"IsRefundable": true,
"IsPanRequiredAtBook": false,
"IsPanRequiredAtTicket": false,
"IsPassportRequiredAtBook": false,
"IsPassportRequiredAtTicket": false,
"GSTAllowed": true,
"IsCouponAppilcable": true,
"IsGSTMandatory": false,
"AirlineRemark": "CORPORATE FARE.",
"ResultFareType": "RegularFare",
"Fare": {
"Currency": "INR",
"BaseFare": 1350,
"Tax": 720,
"TaxBreakup": [
{
"key": "K3",
"value": 80
},
{
"key": "YQTax",
"value": 0
},
{
"key": "YR",
"value": 250
},
{
"key": "PSF",
"value": 0
},
{
"key": "UDF",
"value": 0
},
{
"key": "INTax",
"value": 0
},
{
"key": "TransactionFee",
"value": 0
},
{
"key": "OtherTaxes",
"value": 390
}
],
"YQTax": 0,
"AdditionalTxnFeeOfrd": 0,
"AdditionalTxnFeePub": 0,
"PGCharge": 0,
"OtherCharges": 0,
"ChargeBU": [
{
"key": "TBOMARKUP",
"value": 0
},
{
"key": "GLOBALPROCUREMENTCHARGE",
"value": 0
},
{
"key": "CONVENIENCECHARGE",
"value": 0
},
{
"key": "OTHERCHARGE",
"value": 0
}
],
"Discount": 0,
"PublishedFare": 2070,
"CommissionEarned": 11.9,
"PLBEarned": 0,
"IncentiveEarned": 0,
"OfferedFare": 2058.1,
"TdsOnCommission": 4.76,
"TdsOnPLB": 0,
"TdsOnIncentive": 0,
"ServiceFee": 0,
"TotalBaggageCharges": 0,
"TotalMealCharges": 0,
"TotalSeatCharges": 0,
"TotalSpecialServiceCharges": 0
},
"FareBreakdown": [
{
"Currency": "INR",
"PassengerType": 1,
"PassengerCount": 1,
"BaseFare": 1350,
"Tax": 720,
"TaxBreakUp": [
{
"key": "K3",
"value": 80
},
{
"key": "YR",
"value": 250
},
{
"key": "OtherTaxes",
"value": 390
}
],
"YQTax": 0,
"AdditionalTxnFeeOfrd": 0,
"AdditionalTxnFeePub": 0,
"PGCharge": 0,
"SupplierReissueCharges": 0
}
],
"Segments": [
[
{
"Baggage": "15 KG",
"CabinBaggage": null,
"CabinClass": 2,
"TripIndicator": 1,
"SegmentIndicator": 1,
"Airline": {
"AirlineCode": "AI",
"AirlineName": "Air India",
"FlightNumber": "9643",
"FareClass": "S",
"OperatingCarrier": "9I-643"
},
"NoOfSeatAvailable": 6,
"Origin": {
"Airport": {
"AirportCode": "DEL",
"AirportName": "Indira Gandhi Airport",
"Terminal": "3",
"CityCode": "DEL",
"CityName": "Delhi",
"CountryCode": "IN",
"CountryName": "India"
},
"DepTime": "2021-09-09T19:30:00"
},
"Destination": {
"Airport": {
"AirportCode": "JAI",
"AirportName": "Jaipur",
"Terminal": "2",
"CityCode": "JAI",
"CityName": "Jaipur",
"CountryCode": "IN",
"CountryName": "India"
},
"ArrTime": "2021-09-09T20:35:00"
},
"Duration": 65,
"GroundTime": 0,
"Mile": 0,
"StopOver": false,
"FlightInfoIndex": "",
"StopPoint": "",
"StopPointArrivalTime": "0001-01-01T00:00:00",
"StopPointDepartureTime": "0001-01-01T00:00:00",
"Craft": "ATR",
"Remark": null,
"IsETicketEligible": true,
"FlightStatus": "Confirmed",
"Status": ""
}
]
],
"LastTicketDate": "2021-09-09T23:59:00.000",
"TicketAdvisory": null,
"FareRules": [
{
"Origin": "DEL",
"Destination": "JAI",
"Airline": "AI",
"FareBasisCode": "SIP9I",
"FareRuleDetail": "",
"FareRestriction": "",
"FareFamilyCode": "",
"FareRuleIndex": ""
}
],
"PenaltyCharges": {
"ReissueCharge": "3000 INR",
"CancellationCharge": "3000 INR"
},
"AirlineCode": "AI",
"ValidatingAirline": "AI"
}
]
]
}
}
}