ZuelPay
  1. Flight Booking API
  • API DOCUMENTS
  • Auth
  • Account
    • balance
      POST
  • Verification API
    • pan
      POST
    • voter
      POST
    • aadhar-genrate-otp
      POST
    • aadhar-verify
      POST
    • upi
      POST
    • bank
      POST
    • licesnce
      POST
    • passport
      POST
    • GSTIN LookUp
      POST
    • FASTAG
      POST
  • Recharge API
    • operators
      GET
    • payment
      POST
  • UPI PAYMENT API
    • payment
      POST
  • Operator Lookup API
    • operator_lookup
      POST
  • Mobile Tariff Plans
    • mobile_recharge_plans
      POST
  • Utility Bill Pay API
    • Get Category
      GET
    • Biller Lists
      GET
    • Biller Fetch
      POST
    • Biller Payment
      POST
  • Gift Card/ Brand Voucher API
    • Get Category
    • Brand Lists
    • Buy Giftcard Voucher
  • webhook/callback
    • webhook
  • Recharge Validation API
    • validation
  • PAYOUT API
    • payment
  • Flight Booking API
    • cityList
      GET
    • flightList
      POST
    • flightRePrice
      POST
    • flightBook
      POST
  • Bus Booking API
    • cityList
    • searchBus
    • seatLayout
    • blockSeat
    • bookSeat
    • cancelTicket
  1. Flight Booking API

flightList

POST
/travel/flight/flightList
ParametersRequired/OptionalParameter Description
SearchDetailsRequiredThis parameter gets and sets the entire flight search – specified properties entered by user. These search parameters should be submiited as query string with URL. More
TripTypeRequiredThis is an Enumeration type parameter which has a specified list of values OneWay=0 and RoundTrip=1.
AdultsRequiredDomain for this field contains values from 1-9. At least one adult must be selected.
ChildsOptionalDomain range for this field is 0-9.
InfantsOptionalThis field’s domain has values from 0-2. Number of infants cannot be more than number of adults as per single booking.
CabinOptinalThis field has enumeration values (Economy =0,Business=2)
EngineIDRequiredThis parameter has been defined as Enumeration type which has specified list of constant values. Each int value has been assigned to a different airline Indigo = 0, Spicjet = 1, GoAir = 5, TravelPort = 7, AirAsia=10, AirCosta = 6, Trujet=11
RESPONSE : DATA
ParametersParameter Description
ErrorsIf request has not been submitted successfully or is there any technical error while submitting the request then user will get error with code and description in response.
JourneysIt includes JourneyDetail and Segments
  Errors
ErrorDescriptionErrorDescription
001Object not initialized009Origin required
002Authentication Object not initialized010Destination required
003UserName is required011Travellers required
004Password is required012AdultTraveller required
005Invalid UserName or Password.013BookSegment required
006unique TransactionId is required014Segment ItineraryKey has to be same. or Both Segment have same Origin.
007Search details required015Bond ItineraryKey has to be same.
008Begin date required016Bond ItineraryKey has not null.
JourneyDetail
ParametersData TypeParameter Description
OriginstringThis value represents source city name. Three alphabetic IATA code should be entered by user to get valid source city. This field should not contain More than and less than 3 characters.
DestinationstringIt represents destination city/airport name .It cannot be same as source value. Three alphabetic IATA code should be entered by user to get valid destination city. This field should not contain More than and less than 3 characters.
BeginDateDateTimeIt represents journey date. This value should be entered as string not less than and More than 10 characters in date format ‘yyyy-mm-dd’.
EndDateDateTimeIt represents return date and should be entered as string not less than and More than 10 characters in date format ‘yyyy-mm-dd’. It cannot be greater than journey date
EngineIDEnumeration TypeThis parameter has been defined as Enumeration type which has specified list of constant values. Each int value has been assigned to a different airline Indigo = 0, Spicjet = 1, GoAir = 5, TravelPort = 7, AirAsia=10, AirCosta = 6, Trujet=11
CabinstringThis field has enumeration values (Economy, Business and First class)
CurrencyCodestringThis element represents currency code for a speific country (like INR for Indian Rupee).
  Segments
ParametersData TypeParametersData Type
BondTypestringIsInternationalbool
BondsClass TypeIsRoundTripbool
Deeplinkstring(only for meta search user)IsSpecialbool
EngineIDEnumeration TypeIsSpecialIdbool
FareClass TypeItineraryKeystring
FareRulestringJourneyIndexint
IsBaggageFareboolNearByAirportbool
IsCacheboolRemarkstring
IsHoldBookingboolSearchIdstring
  Bonds
ParameterData TypeParameter Description
BoundTypestringRepresents Inbound/Outbound flight
ItineraryKeystringRepresents a string value for a particular journey from source to destination
IsBaggageFareboolFares for baggage facility(True/False)
IsSSRboolIt contains boolean value(True/False)
JourneyTimestringRepresents journey duration
LegsClass TypeRepresents details about flight
SpecialServicesClass TypeRepresents special services provided in flight   More
  Legs
ParameterData TypeParameter Description
AircraftCodestringThis is provided by airline (for eg: VX09KHT7TSm+ZhCrSZcPJg==)
AircraftTypestringProvided by airline
AirlineNamestringRepresents name of the airline(Spice Jet,Indigo,GoAir,GDS)
AmountdecimalCalculated amount of other services like tax, PSF, UDF
ArrivalDateDateTimeIt represents arrival date of the Journey.
ArrivalTerminalstringIt represents arrival terminal of the Journey.
ArrivalTimestringIt represents arrival time of the Journey.
AvailableSeatstringTotal numbers of seats available.
BaggageUnitstringUnits like KG and G etc.
BaggageWeightstringIt represents the weight of the baggage.
BoundTypestringRepresents Inbound/Outbound flight
CabinstringThis field has enumeration values (Economy =0,Business=2)
CabinClassesClass Type
CapacityshortTotal capacity
CarrierCodestringFlight carrier code
CurrencyCodestringRepresents currency codes(INR for india)
DepartureDatestringIt represents departure date of the journey.
DepartureTerminalstringIt represents departure terminal of the Journey.
DepartureTimeDateTimeIt represents departure time of the journey.
DestinationstringIt represents destination city/airport name .It cannot be same as source value. Three alphabetic IATA code should be entered by user to get valid destination city. This field should not contain More than and less than 3 characters.
DurationstringIt represents the total time duration of the journey.
FareBasisCodestringFlight fare basis code
FareClassOfServicestringIt is an array type having a list of constant values.
FlightDesignatorstringFlight designator details
FlightDetailRefKeystringId for flight details
FlightNumberstringIt represents the flight number.
Groupstring
IsConnectingboolIt contains boolean value(True/False)
NumberOfStopsstringTotal number of stops between source to destination
OriginstringThis value represents source city name. Three alphabetic IATA code should be entered by user to get valid source city. This field should not contain More than and less than 3 characters.
ProviderCodestringAirline provider code
RemarksstringBrief description
SSRDetailsClass TypeMore
Soldint
StatusstringStatus of the booking
  Fare
ParametersData TypeParameter Description
BasicFaredecimalRepresents basic fares excluding of any other service charges
ExchangeRatedecimalExchange Rate
PaxFaresClass TypeIt contains information about BaggageUnit,BaggageWeight,BasicFare and PaxType.
TotalFareWithOutMarkUpdecimalTotal amount
TotalTaxWithOutMarkUpdecimalTotal tax
  PaxFares
ParameterData TypeParameter Description
BaggageUnitstring>Units like KG and G etc.
BaggageWeightstringIt represents the weight of the baggage.
BaseTransactionAmountdecimalIt contains transaction amount
BasicFaredecimalRepresents basic fares excluding of any other service charges
CancelPenaltydecimalCancel before departure date within twenty four hours(CAN-BEF 24_0:14811)
ChangePenaltydecimalChange before departure date within twenty fore hours (CHG-BEF 24_0:4443.0)
EquivCurrencyCodestringFlight equivalent currency code
FareClass TypeIt includes fare detail  More
FareBasisCodestringFlight fare basis code
FareInfoKeystringFlight fare information key
FareInfoValuestringFlight fare information value
MarkUPdecimalFlight markup
PaxTypeEnumeration TypeThis property has enumeration type and has specified list of constant values as (ADT, CHD and INF)
RefundableboolRepresents whether this flight is refundable or non refundable
TotalFaredecimalCalculated amount of other services like tax, PSF, UDF
TotalTaxdecimalTotal tax
TransactionAmountdecimalTransaction amount
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/travel/flight/flightList' \
--header 'Token: ZKEYza2COHK0QVkcVkwUb6WeIgWiS' \
--header 'checkSum: 739f448d1cc4f5bbbd048e68ba2b8885b0f8414ed4090ad967df7d15d7cdbbae' \
--header 'Content-Type: application/json' \
--data-raw '{
    "FlightSearchDetails": [
        {
            "Origin": "BOM",
            "Destination": " GOI",
            "BeginDate": "2020-09-29"
        }
    ],
    "EngineID": [
        7,
        0,
        1,
        5,
        10,
        6,
        11
    ],
    "TripType": 0,
    "Cabin": 0,
    "Adults": "1",
    "Childs": "0",
    "Infants": "0"
}'
Response Response Example
{
    "Errors": null,
    "Insurance": null,
    "Journeys": [
        {
            "JourneyDetail": null,
            "Segments": [
                {
                    "BondType": "OutBound",
                    "Bonds": [
                        {
                            "BoundType": "OutBound",
                            "IsBaggageFare": false,
                            "IsSSR": false,
                            "ItineraryKey": "b7SqRwmVDL7OJQP+J0ySES9vx7BMZSMJFZdVwW+LEF0=",
                            "JourneyTime": "01h 20m",
                            "Legs": [
                                {
                                    "AircraftCode": "6E",
                                    "AircraftType": "320",
                                    "AirlineName": "6E",
                                    "AirlinePnr": null,
                                    "ArrivalDate": "Tue-29Sep2020",
                                    "ArrivalTerminal": "",
                                    "ArrivalTime": "12:40",
                                    "AvailableSeat": null,
                                    "BaggageUnit": "KG",
                                    "BaggageWeight": "20",
                                    "BookSeat": null,
                                    "BoundType": "OutBound",
                                    "Cabin": "Economy",
                                    "CabinClasses": null,
                                    "Capacity": 0,
                                    "CarrierCode": "6E",
                                    "CurrencyCode": "INR",
                                    "DepartureDate": "Tue-29Sep2020",
                                    "DepartureTerminal": "1",
                                    "DepartureTime": "11:20",
                                    "Destination": "GOI",
                                    "Duration": "01h 20m",
                                    "FareBasisCode": "Q0IP",
                                    "FareClassOfService": "Q",
                                    "FareRulesKey": null,
                                    "FlightDesignator": null,
                                    "FlightDetailRefKey": "6E~ 179~ ~~BOM~09/29/2020 11:20~GOI~09/29/2020 12:40~~",
                                    "FlightName": "Indigo",
                                    "FlightNumber": " 179",
                                    "GDSPnr": null,
                                    "Group": "0",
                                    "IsConnecting": false,
                                    "IsSeatOpen": false,
                                    "LayoverArrDT": null,
                                    "LayoverAt": null,
                                    "LayoverDepDT": null,
                                    "LayoverDuration": null,
                                    "NumberOfStops": "0",
                                    "OperatedBy": "",
                                    "Origin": "BOM",
                                    "ProviderCode": "6E` 179` ``BOM`09/29/2020 11:20`GOI`09/29/2020 12:40``!0`Q` `6E`Q0IP`1057``0`3``X!!6E`320```KG`20`Economy``6E`1`0`False`0``````01h 20m`Q0IP`Q",
                                    "Remarks": null,
                                    "SSRDetails": null,
                                    "Sold": 0,
                                    "Status": null
                                }
                            ],
                            "addOnDetail": null
                        }
                    ],
                    "CurrencyCode": "INR",
                    "Deeplink": "",
                    "EngineID": 0,
                    "Fare": {
                        "BasicFare": 2500,
                        "BrandKeys": null,
                        "DueAmount": 0,
                        "ExchangeRate": 0,
                        "FareName": 7,
                        "OfferedFare": 0,
                        "PNRAmount": 0,
                        "PaxFares": [
                            {
                                "AirlinePnr": null,
                                "BaggageUnit": "KG",
                                "BaggageWeight": "20",
                                "BaseTransactionAmount": 0,
                                "BasicFare": 2500,
                                "Branded": null,
                                "CancelPenalty": 3000,
                                "Cashback": 0,
                                "ChangePenalty": 2500,
                                "Commission": 0,
                                "DFValue": "0",
                                "EquivCurrencyCode": "INR",
                                "Fare": [
                                    {
                                        "Amount": 549,
                                        "ChargeCode": "Tax",
                                        "ChargeType": "Tax"
                            

Request

Header Params
Token
string 
required
Example:
ZKEYza2COHK0QVkcVkwUb6WeIgWiS
checkSum
string 
required
Example:
739f448d1cc4f5bbbd048e68ba2b8885b0f8414ed4090ad967df7d15d7cdbbae
Body Params application/json
FlightSearchDetails
array [object {3}] 
required
Origin
string 
optional
Destination
string 
optional
BeginDate
string 
optional
EngineID
array[integer]
required
TripType
integer 
required
Cabin
integer 
required
Adults
string 
required
Childs
string 
required
Infants
string 
required
Examples

Responses

🟢200success
application/json
Body
Errors
null 
required
Insurance
null 
required
Journeys
array [object {2}] 
required
JourneyDetail
null 
optional
Segments
array [object {35}] 
optional
TraceId
string 
required
api_mode
string 
required
Previous
cityList
Next
flightRePrice
Built with