1. SearchOnlyAviaPackages

Version 9.1 by Giorgi Mdivnishvili on 2023/12/26 15:05

Method Description

The initial method of the integration process is authorization. You will be provided with a test user username and password to generate the access token that you will need to pass in all the following methods. 

Endpoint URL - [POST]

Request Parameters

None

Request Body

{
 "flightRequests": [
    {
     "departureDate": "2023-12-18T08:33:20.358Z",
     "returnDate": "2023-12-18T08:33:20.358Z",
     "departureLocation": "string",
     "departureType": "string",
     "arrivalLocation": "string",
     "arrivalType": "string"
    }
  ],
 "adults": 0,
 "children": 0,
 "childrenAges": [
   0
  ],
 "ticketType": "string",
 "longConnectTime": true,
 "directFlightsOnly": true,
 "pagingId": "string",
 "pageNumber": 0,
 "pageRowCount": 0
}

Request Body example

{
 "flightRequests": [
     {
       "arrivalLocation": "DXB",
       "arrivalType": "airport",
       "departureDate": "2023-12-22T20:00:00.000Z",
       "departureLocation": "ALA",
       "departureType": "airport",
       "returnDate": "2023-12-28T20:00:00.000Z"
    }
  ],
 "adults": 1,
 "children": 0,
 "isBusinessClass": false,
 "_flightTicketType": "roundTrip"
}

Response

{
 "airlines": [
    {
     "airlineCode": "string",
     "iataCode": "string",
     "icaoCode": "string",
     "airlineName": "string",
     "note": "string",
     "infantMaxAge": 0,
     "childMaxAge": 0
    }
  ],
 "packages": [
    {
     "id": "string",
     "priceCurrency": "string",
     "totalPrice": 0,
     "flight": {
       "id": "string",
       "departureDate": "2023-12-18T08:33:20.359Z",
       "returnDate": "2023-12-18T08:33:20.359Z",
       "departureTicketsLeft": 0,
       "returnTicketsLeft": 0,
       "departureAvailabilityType": "OnRequest",
       "returnAvailabilityType": "OnRequest",
       "isTwoWay": true,
       "departureSegments": [
          {
           "airlineCode": "string",
           "airlineName": "string",
           "flightCode": "string",
           "class": "string",
           "lugageWeight": 0,
           "handLugageWeight": 0,
           "departureFlightDate": "2023-12-18T08:33:20.359Z",
           "departureCountryName": "string",
           "departureCityName": "string",
           "departureAirportCode": "string",
           "departureAirportName": "string",
           "departureTerminalCode": "string",
           "arrivalFlightDate": "2023-12-18T08:33:20.359Z",
           "arrivalCountryName": "string",
           "arrivalCityName": "string",
           "arrivalAirportCode": "string",
           "arrivalAirportName": "string",
           "arrivalTerminalCode": "string",
           "flightDuration": "string",
           "baggages": [
              {
               "baggageCode": "string",
               "description": "string",
               "price": 0,
               "currency": "string",
               "included": true
              }
            ]
          }
        ],
       "returnSegments": [
          {
           "airlineCode": "string",
           "airlineName": "string",
           "flightCode": "string",
           "class": "string",
           "lugageWeight": 0,
           "handLugageWeight": 0,
           "departureFlightDate": "2023-12-18T08:33:20.359Z",
           "departureCountryName": "string",
           "departureCityName": "string",
           "departureAirportCode": "string",
           "departureAirportName": "string",
           "departureTerminalCode": "string",
           "arrivalFlightDate": "2023-12-18T08:33:20.359Z",
           "arrivalCountryName": "string",
           "arrivalCityName": "string",
           "arrivalAirportCode": "string",
           "arrivalAirportName": "string",
           "arrivalTerminalCode": "string",
           "flightDuration": "string",
           "baggages": [
              {
               "baggageCode": "string",
               "description": "string",
               "price": 0,
               "currency": "string",
               "included": true
              }
            ]
          }
        ]
      }
    }
  ],
 "pagingId": "string",
 "pageNumber": 0,
 "pageCount": 0
}

Response example

{
   "airlines": [
        {
           "airlineCode": "KC",
           "iataCode": "KC",
           "airlineName": "Air Astana.",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "FZ",
           "iataCode": "FZ",
           "airlineName": "Fly Dubai.",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "KC",
           "iataCode": "KC",
           "airlineName": "Air Astana-",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "FZ",
           "iataCode": "FZ",
           "airlineName": "Fly Dubai-",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "QR",
           "iataCode": "QR",
           "airlineName": "Qatar Airways-",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "J2",
           "iataCode": "J2",
           "airlineName": "Azerbaijan Airlines-",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "HY",
           "iataCode": "HY",
           "airlineName": "Uzbekistan Airways-",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "TK",
           "iataCode": "TK",
           "airlineName": "Turkish Airlines-",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "MS",
           "iataCode": "MS",
           "airlineName": "Egyptair-",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "PC",
           "iataCode": "PC",
           "airlineName": "Pegasus Airlines-",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "UK",
           "iataCode": "UK",
           "airlineName": "Sabre",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "EK",
           "iataCode": "EK",
           "airlineName": "Emirates-",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "3U",
           "iataCode": "3U",
           "airlineName": "Sabre",
           "infantMaxAge": 0,
           "childMaxAge": 0
        },
        {
           "airlineCode": "CZ",
           "iataCode": "CZ",
           "airlineName": "China Southern Airlines-",
           "infantMaxAge": 0,
           "childMaxAge": 0
        }
    ],
"packages": [
        {
           "id": "onlyavia:a3129509-6799-4e98-a9ab-8566c0009403:026ab654-b452-43cd-9ebb-7e1b365c827a",
           "priceCurrency": "USD",
           "totalPrice": 80.0,
           "flight": {
               "id": "026ab654-b452-43cd-9ebb-7e1b365c827a",
               "departureDate": "2023-12-22T20:00:00.000Z",
               "returnDate": "2023-12-28T20:00:00.000Z",
               "departureTicketsLeft": 15,
               "returnTicketsLeft": 7,
               "departureAvailabilityType": "FreeSale",
               "returnAvailabilityType": "FewPlaces",
               "isTwoWay": true,
               "departureSegments": [
                    {
                       "airlineCode": "KC",
                       "airlineName": "Air Astana.",
                       "flightCode": "KC897",
                       "class": "econom",
                       "lugageWeight": 20,
                       "handLugageWeight": 6,
                       "departureFlightDate": "2023-12-22T20:00:00.000Z",
                       "departureCountryName": "Kazakhstan",
                       "departureCityName": "Almaty",
                       "departureAirportCode": "ALA",
                       "departureAirportName": "Almaty Intl Airport",
                       "departureTerminalCode": "ALA",
                       "arrivalFlightDate": "2023-12-22T20:00:00.000Z",
                       "arrivalCountryName": "United Arab Emirates",
                       "arrivalCityName": "Dubai",
                       "arrivalAirportCode": "DXB",
                       "arrivalAirportName": "Dubai Intl Airport",
                       "arrivalTerminalCode": "DXB1",
                       "flightDuration": "0h 50m",
                       "baggages": [
                            {
                               "baggageCode": "INCLUDED",
                               "description": "20 KG INCLUDED",
                               "price": 0.0,
                               "currency": "USD",
                               "included": true
                            }
                        ]
                    }
                ],
               "returnSegments": [
                    {
                       "airlineCode": "KC",
                       "airlineName": "Air Astana.",
                       "flightCode": "KC898",
                       "class": "econom",
                       "lugageWeight": 20,
                       "handLugageWeight": 6,
                       "departureFlightDate": "2023-12-28T20:00:00.000Z",
                       "departureCountryName": "United Arab Emirates",
                       "departureCityName": "Dubai",
                       "departureAirportCode": "DXB",
                       "departureAirportName": "Dubai Intl Airport",
                       "departureTerminalCode": "DXB1",
                       "arrivalFlightDate": "2023-12-28T20:00:00.000Z",
                       "arrivalCountryName": "Kazakhstan",
                       "arrivalCityName": "Almaty",
                       "arrivalAirportCode": "ALA",
                       "arrivalAirportName": "Almaty Intl Airport",
                       "arrivalTerminalCode": "ALA",
                       "flightDuration": "8h 15m",
                       "baggages": [
                            {
                               "baggageCode": "INCLUDED",
                               "description": "20 KG INCLUDED",
                               "price": 0.0,
                               "currency": "USD",
                               "included": true
                            }
                        ]
                    }
                ]
            }
        },
        {
           "id": "onlyavia:a3129509-6799-4e98-a9ab-8566c0009403:e4d71fb2-18e7-4cbc-a8de-4dee96f8d859",
           "priceCurrency": "USD",
           "totalPrice": 80.0,
           "flight": {
               "id": "e4d71fb2-18e7-4cbc-a8de-4dee96f8d859",
               "departureDate": "2023-12-22T20:00:00.000Z",
               "returnDate": "2023-12-28T20:00:00.000Z",
               "departureTicketsLeft": 15,
               "returnTicketsLeft": 30,
               "departureAvailabilityType": "FewPlaces",
               "returnAvailabilityType": "FreeSale",
               "isTwoWay": true,
               "departureSegments": [
                    {
                       "airlineCode": "KC",
                       "airlineName": "Air Astana.",
                       "flightCode": "KC897",
                       "class": "econom",
                       "lugageWeight": 20,
                       "handLugageWeight": 6,
                       "departureFlightDate": "2023-12-22T20:00:00.000Z",
                       "departureCountryName": "Kazakhstan",
                       "departureCityName": "Almaty",
                       "departureAirportCode": "ALA",
                       "departureAirportName": "Almaty Intl Airport",
                       "departureTerminalCode": "ALA",
                       "arrivalFlightDate": "2023-12-22T20:00:00.000Z",
                       "arrivalCountryName": "United Arab Emirates",
                       "arrivalCityName": "Dubai",
                       "arrivalAirportCode": "DXB",
                       "arrivalAirportName": "Dubai Intl Airport",
                       "arrivalTerminalCode": "DXB1",
                       "flightDuration": "0h 50m",
                       "baggages": [
                            {
                               "baggageCode": "INCLUDED",
                               "description": "20 KG INCLUDED",
                               "price": 0.0,
                               "currency": "USD",
                               "included": true
                            }
                        ]
                    }
                ],
               "returnSegments": [
                    {
                       "airlineCode": "KC",
                       "airlineName": "Air Astana.",
                       "flightCode": "KC900",
                       "class": "econom",
                       "lugageWeight": 20,
                       "handLugageWeight": 6,
                       "departureFlightDate": "2023-12-28T20:00:00.000Z",
                       "departureCountryName": "United Arab Emirates",
                       "departureCityName": "Dubai",
                       "departureAirportCode": "DXB",
                       "departureAirportName": "Dubai Intl Airport",
                       "departureTerminalCode": "DXB1",
                       "arrivalFlightDate": "2023-12-27T20:00:00.000Z",
                       "arrivalCountryName": "Kazakhstan",
                       "arrivalCityName": "Almaty",
                       "arrivalAirportCode": "ALA",
                       "arrivalAirportName": "Almaty Intl Airport",
                       "arrivalTerminalCode": "ALA",
                       "flightDuration": "-45m",
                       "baggages": [
                            {
                               "baggageCode": "INCLUDED",
                               "description": "20 KG INCLUDED",
                               "price": 0.0,
                               "currency": "USD",
                               "included": true
                            }
                        ]
                    }
                ]
            }
        },
        {
           "id": "onlyavia:a3129509-6799-4e98-a9ab-8566c0009403:9501fa2a-aaaa-49bf-9e4f-532f4742a45c",
           "priceCurrency": "USD",
           "totalPrice": 80.0,
           "flight": {
               "id": "9501fa2a-aaaa-49bf-9e4f-532f4742a45c",
               "departureDate": "2023-12-22T20:00:00.000Z",
               "returnDate": "2023-12-28T20:00:00.000Z",
               "departureTicketsLeft": 26,
               "returnTicketsLeft": 30,
               "departureAvailabilityType": "FewPlaces",
               "returnAvailabilityType": "FreeSale",
               "isTwoWay": true,
               "departureSegments": [
                    {
                       "airlineCode": "KC",
                       "airlineName": "Air Astana.",
                       "flightCode": "KC899",
                       "class": "econom",
                       "lugageWeight": 20,
                       "handLugageWeight": 6,
                       "departureFlightDate": "2023-12-22T20:00:00.000Z",
                       "departureCountryName": "Kazakhstan",
                       "departureCityName": "Almaty",
                       "departureAirportCode": "ALA",
                       "departureAirportName": "Almaty Intl Airport",
                       "departureTerminalCode": "ALA",
                       "arrivalFlightDate": "2023-12-22T20:00:00.000Z",
                       "arrivalCountryName": "United Arab Emirates",
                       "arrivalCityName": "Dubai",
                       "arrivalAirportCode": "DXB",
                       "arrivalAirportName": "Dubai Intl Airport",
                       "arrivalTerminalCode": "DXB1",
                       "flightDuration": "0h 55m",
                       "baggages": [
                            {
                               "baggageCode": "INCLUDED",
                               "description": "20 KG INCLUDED",
                               "price": 0.0,
                               "currency": "USD",
                               "included": true
                            }
                        ]
                    }
                ],
               "returnSegments": [
                    {
                       "airlineCode": "KC",
                       "airlineName": "Air Astana.",
                       "flightCode": "KC900",
                       "class": "econom",
                       "lugageWeight": 20,
                       "handLugageWeight": 6,
                       "departureFlightDate": "2023-12-28T20:00:00.000Z",
                       "departureCountryName": "United Arab Emirates",
                       "departureCityName": "Dubai",
                       "departureAirportCode": "DXB",
                       "departureAirportName": "Dubai Intl Airport",
                       "departureTerminalCode": "DXB1",
                       "arrivalFlightDate": "2023-12-27T20:00:00.000Z",
                       "arrivalCountryName": "Kazakhstan",
                       "arrivalCityName": "Almaty",
                       "arrivalAirportCode": "ALA",
                       "arrivalAirportName": "Almaty Intl Airport",
                       "arrivalTerminalCode": "ALA",
                       "flightDuration": "-45m",
                       "baggages": [
                            {
                               "baggageCode": "INCLUDED",
                               "description": "20 KG INCLUDED",
                               "price": 0.0,
                               "currency": "USD",
                               "included": true
                            }
                        ]
                    }
                ]
            }
        },
        {
           "id": "onlyavia:a3129509-6799-4e98-a9ab-8566c0009403:d186456b-7640-47f7-b083-790026809190",
           "priceCurrency": "USD",
           "totalPrice": 80.0,
           "flight": {
               "id": "d186456b-7640-47f7-b083-790026809190",
               "departureDate": "2023-12-22T20:00:00.000Z",
               "returnDate": "2023-12-28T20:00:00.000Z",
               "departureTicketsLeft": 26,
               "returnTicketsLeft": 7,
               "departureAvailabilityType": "FreeSale",
               "returnAvailabilityType": "FewPlaces",
               "isTwoWay": true,
               "departureSegments": [
                    {
                       "airlineCode": "KC",
                       "airlineName": "Air Astana.",
                       "flightCode": "KC899",
                       "class": "econom",
                       "lugageWeight": 20,
                       "handLugageWeight": 6,
                       "departureFlightDate": "2023-12-22T20:00:00.000Z",
                       "departureCountryName": "Kazakhstan",
                       "departureCityName": "Almaty",
                       "departureAirportCode": "ALA",
                       "departureAirportName": "Almaty Intl Airport",
                       "departureTerminalCode": "ALA",
                       "arrivalFlightDate": "2023-12-22T20:00:00.000Z",
                       "arrivalCountryName": "United Arab Emirates",
                       "arrivalCityName": "Dubai",
                       "arrivalAirportCode": "DXB",
                       "arrivalAirportName": "Dubai Intl Airport",
                       "arrivalTerminalCode": "DXB1",
                       "flightDuration": "0h 55m",
                       "baggages": [
                            {
                               "baggageCode": "INCLUDED",
                               "description": "20 KG INCLUDED",
                               "price": 0.0,
                               "currency": "USD",
                               "included": true
                            }
                        ]
                    }
                ],
               "returnSegments": [
                    {
                       "airlineCode": "KC",
                       "airlineName": "Air Astana.",
                       "flightCode": "KC898",
                       "class": "econom",
                       "lugageWeight": 20,
                       "handLugageWeight": 6,
                       "departureFlightDate": "2023-12-28T20:00:00.000Z",
                       "departureCountryName": "United Arab Emirates",
                       "departureCityName": "Dubai",
                       "departureAirportCode": "DXB",
                       "departureAirportName": "Dubai Intl Airport",
                       "departureTerminalCode": "DXB1",
                       "arrivalFlightDate": "2023-12-28T20:00:00.000Z",
                       "arrivalCountryName": "Kazakhstan",
                       "arrivalCityName": "Almaty",
                       "arrivalAirportCode": "ALA",
                       "arrivalAirportName": "Almaty Intl Airport",
                       "arrivalTerminalCode": "ALA",
                       "flightDuration": "8h 15m",
                       "baggages": [
                            {
                               "baggageCode": "INCLUDED",
                               "description": "20 KG INCLUDED",
                               "price": 0.0,
                               "currency": "USD",
                               "included": true
                            }
                        ]
                    }
                ]
            }
        },
        {

Schema

Success

SearchOnlyAviaPackagesResponse{

airlines[
nullable: trueAirline{
airlineCodestring
nullable: true
readOnly: true
iataCodestring
nullable: true
icaoCodestring
nullable: true
airlineNamestring
nullable: true
notestring
nullable: true
infantMaxAgenumber($double)
childMaxAgenumber($double)

}]

packages[
nullable: trueOnlyAviaPackage{
idstring
nullable: true
priceCurrencystring
nullable: true
totalPricenumber($double)
flightPackageFlight{
idstring
nullable: true
departureDatestring($date-time)
returnDatestring($date-time)
nullable: true
departureTicketsLeftinteger($int32)
returnTicketsLeftinteger($int32)
departureAvailabilityTypeFlightAvailabilityTypestringEnum:
[ OnRequest, FreeSale, FewPlaces, StopSale ]
returnAvailabilityTypeFlightAvailabilityTypestringEnum:
[ OnRequest, FreeSale, FewPlaces, StopSale ]
isTwoWayboolean
departureSegments[
nullable: trueFlightSegment{
airlineCodestring
nullable: true
airlineNamestring
nullable: true
flightCodestring
nullable: true
classstring
nullable: true
lugageWeightnumber($double)
handLugageWeightnumber($double)
departureFlightDatestring($date-time)
departureCountryNamestring
nullable: true
departureCityNamestring
nullable: true
departureAirportCodestring
nullable: true
departureAirportNamestring
nullable: true
departureTerminalCodestring
nullable: true
arrivalFlightDatestring($date-time)
arrivalCountryNamestring
nullable: true
arrivalCityNamestring
nullable: true
arrivalAirportCodestring
nullable: true
arrivalAirportNamestring
nullable: true
arrivalTerminalCodestring
nullable: true
flightDurationstring
nullable: true
baggages[
nullable: trueBaggage{
baggageCodestring
nullable: true
descriptionstring
nullable: true
pricenumber($double)
currencystring
nullable: true
includedboolean

}]

}]

returnSegments[
nullable: trueFlightSegment{
airlineCodestring
nullable: true
airlineNamestring
nullable: true
flightCodestring
nullable: true
classstring
nullable: true
lugageWeightnumber($double)
handLugageWeightnumber($double)
departureFlightDatestring($date-time)
departureCountryNamestring
nullable: true
departureCityNamestring
nullable: true
departureAirportCodestring
nullable: true
departureAirportNamestring
nullable: true
departureTerminalCodestring
nullable: true
arrivalFlightDatestring($date-time)
arrivalCountryNamestring
nullable: true
arrivalCityNamestring
nullable: true
arrivalAirportCodestring
nullable: true
arrivalAirportNamestring
nullable: true
arrivalTerminalCodestring
nullable: true
flightDurationstring
nullable: true
baggages[
nullable: trueBaggage{
baggageCodestring
nullable: true
descriptionstring
nullable: true
pricenumber($double)
currencystring
nullable: true
includedboolean

}]

}]

}

}]

pagingIdstring
nullable: true
pageNumberinteger($int64)
pageCountinteger($int64)

}

Important

Error

It's Important to in every other request header, put Auth token

Key - Authorization

Value - Bearer Token what is given in this response.

also note in headers that:

Content-Type - application/json

Key - X-nugios-timezone

Value - 240