Flights

Get Clusters Availability

GET https://api.basset.ws/flights/clusters

Query Parameters

Name	Type	Description
dates	string	List of comma separated dates in format yyyy-MM-dd representing the departure dates of each segment
from	string	List of comma separated IATA Codes representing the departure airport of each segment
to	string	List of comma separated IATA Codes representing the arrival airport of each segment
site	string	ISO 3166-2 country code
channel	string	WEB or DESKTOP
adults	number	Number of adults
seniors	number	Number of seniors (third-age)
disabled	number	Number of passengers with disabilities
children	number	Number of children
infants	number	Number of infants
page	number	Number of page to request
page_size	number	The size of the requested page
stops	number	List of comma separated stops to filter
airlines	string	List of comma separated IATA codes of airlines to filter
outbound_departure_airports	string	List of comma separated IATA codes representing the outbound departure airports to filter
outbound_arrival_airports	string	List of comma separated IATA codes representing the outbound arrival airports to filter
outbound_departure_time	string	Pair of comma separated schedules that represents the minimum and maximum time of outbound departure
inbound_departure_airports	string	List of comma separated IATA codes representing the inbound departure airports to filter **
inbound_arrival_airports	string	List of comma separated IATA codes representing the inbound arrival airports to filter **
inbound_departure_time	string	Pair of comma separated schedules that represents the minimum and maximum time of inbound departure **

200

{
  "clusters": [
    {
      "segments": [
        {
          "origin": {
            "code": "EZE",
            "name": "Buenos Aires, Argentina (EZE-Ministro Pistarini Intl.)"
          },
          "destination": {
            "code": "CDG",
            "name": "Paris, France (CDG-Roissy-Charles de Gaulle)"
          },
          "departure_date": "2018-12-10",
          "options": [
            
          ]
        },
        {
          "origin": {
            "code": "ORY",
            "name": "Paris, Francia (ORY-Orly)"
          },
          "destination": {
            "code": "EZE",
            "name": "Buenos Aires, Argentina (EZE-Ministro Pistarini Intl.)"
          },
          "departure_date": "2018-12-16",
          "options": [
            {
              "id": "6855463430059123414",
              "departure_date": "2018-12-16",
              "departure_time": "06:55",
              "arrival_date": "2018-12-17",
              "arrival_time": "17:45",
              "duration": "38:50",
              "legs": [
                {
                  "origin": {
                    "code": "ORY",
                    "name": "Paris, Francia (ORY-Orly)"
                  },
                  "destination": {
                    "code": "BCN",
                    "name": "Barcelona, Spain (BCN-Barcelona Intl.)"
                  },
                  "departure_date": "2018-12-16",
                  "departure_time": "06:55",
                  "arrival_date": "2018-12-16",
                  "arrival_time": "08:30",
                  "marketing_carrier": {
                    "code": "IB",
                    "name": "Iberia"
                  },
                  "operating_carrier": {
                    "code": "VY",
                    "name": "Vueling"
                  },
                  "duration": "01:35",
                  "flight_number": "5746",
                  "aircraft_type": "Airbus A320-100/200",
                  "cabin_type": {
                    "code": "O",
                    "name": "Economy",
                    "quantity": 4
                  }
                },
                {
                  "origin": {
                    "code": "BCN",
                    "name": "Barcelona, Spain (BCN-Barcelona Intl.)"
                  },
                  "destination": {
                    "code": "EZE",
                    "name": "Buenos Aires, Argentina (EZE-Ministro Pistarini Intl.)"
                  },
                  "departure_date": "2018-12-17",
                  "departure_time": "08:10",
                  "arrival_date": "2018-12-17",
                  "arrival_time": "17:45",
                  "marketing_carrier": {
                    "code": "IB",
                    "name": "Iberia"
                  },
                  "operating_carrier": {
                    "code": "IB",
                    "name": "Iberia"
                  },
                  "duration": "13:35",
                  "flight_number": "2603",
                  "aircraft_type": "Airbus A330-200",
                  "cabin_type": {
                    "code": "L",
                    "name": "Economy",
                    "quantity": 9
                  }
                }
              ],
              "baggage_allowance": [
                
              ]
            }
          ]
        }
      ],
      "price": {
        "adults": {
          "fare": 70640,
          "quantity": 2
        },
        "taxes": 15642.8,
        "charges": 8355.68,
        "total": 94638.47,
        "currency": "ARS"
      },
      "validating_carrier": {
        "code": "IB",
        "name": "Iberia"
      },
      "route_type": "INTERNATIONAL",
      "flight_type": "ROUND_TRIP"
    }
  ],
  "total": 43,
  "limit": 20,
  "offset": 0,
  "filters": {
    "airlines": [
      {
        "code": "AR",
        "name": "Aerolineas Argentinas"
      }
    ],
    "outbound_airports": {
      "outbound": [
        {
          "code": "EZE",
          "name": "Buenos Aires, Argentina (EZE-Ministro Pistarini Intl.)"
        },
        {
          "code": "AEP",
          "name": "Buenos Aires, Argentina (AEP-Aeroparque Jorge Newbery)"
        }
      ],
      "inbound": [
        {
          "code": "ORY",
          "name": "Paris, Francia (ORY-Orly)"
        },
        {
          "code": "CDG",
          "name": "Paris, France (CDG-Roissy-Charles de Gaulle)"
        }
      ]
    },
    "inbound_airports": {
      "outbound": [
        {
          "code": "ORY",
          "name": "Paris, Francia (ORY-Orly)"
        },
        {
          "code": "CDG",
          "name": "Paris, France (CDG-Roissy-Charles de Gaulle)"
        }
      ],
      "inbound": [
        {
          "code": "EZE",
          "name": "Buenos Aires, Argentina (EZE-Ministro Pistarini Intl.)"
        }
      ]
    },
    "stops": [
      1,
      0
    ]
  },
  "matrix": [
    {
      "airline": {
        "code": "IB",
        "name": "Iberia"
      },
      "_stops": {
        
      },
      "stops": {
        "1": {
          "total": 94638.47,
          "currency": "ARS"
        }
      }
    }
  ]
}

** Query parameters only available when the search is round trip

How to generate cluster id?

To generate the ID of the cluster it is necessary to concatenate the ID's found in each option with an underscore (_)

Get Cluster by id

GET https://api.basset.ws/flights/clusters/:id

Path Parameters

Name	Type	Description
id	string	Cluster id

Query Parameters

Name	Type	Description
site	string	ISO 3166-2 country code
channel	string	WEB or DESKTOP

200

{
  "segments": [
    {
      "origin": {
        "code": "EZE",
        "name": "Buenos Aires, Argentina (EZE-Ministro Pistarini Intl.)"
      },
      "destination": {
        "code": "CDG",
        "name": "Paris, France (CDG-Roissy-Charles de Gaulle)"
      },
      "departure_date": "2018-12-10",
      "options": [
        {
          "id": "5248694896813658527",
          "departure_date": "2018-12-10",
          "departure_time": "13:00",
          "arrival_date": "2018-12-11",
          "arrival_time": "18:25",
          "duration": "25:25",
          "legs": [
            {
              "origin": {
                "code": "EZE",
                "name": "Buenos Aires, Argentina (EZE-Ministro Pistarini Intl.)"
              },
              "destination": {
                "code": "BCN",
                "name": "Barcelona, Spain (BCN-Barcelona Intl.)"
              },
              "departure_date": "2018-12-10",
              "departure_time": "13:00",
              "arrival_date": "2018-12-11",
              "arrival_time": "05:30",
              "marketing_carrier": {
                "code": "IB",
                "name": "Iberia"
              },
              "operating_carrier": {
                "code": "IB",
                "name": "Iberia"
              },
              "duration": "12:30",
              "flight_number": "2602",
              "aircraft_type": "Airbus A330-200",
              "cabin_type": {
                "code": "Q",
                "name": "Economy",
                "quantity": 5
              }
            },
            {
              "origin": {
                "code": "BCN",
                "name": "Barcelona, Spain (BCN-Barcelona Intl.)"
              },
              "destination": {
                "code": "CDG",
                "name": "Paris, France (CDG-Roissy-Charles de Gaulle)"
              },
              "departure_date": "2018-12-11",
              "departure_time": "16:25",
              "arrival_date": "2018-12-11",
              "arrival_time": "18:25",
              "marketing_carrier": {
                "code": "IB",
                "name": "Iberia"
              },
              "operating_carrier": {
                "code": "VY",
                "name": "Vueling"
              },
              "duration": "02:00",
              "flight_number": "5294",
              "aircraft_type": "Airbus A320-100/200",
              "cabin_type": {
                "code": "A",
                "name": "Economy",
                "quantity": 4
              }
            }
          ],
          "baggage_allowance": [
            
          ]
        }
      ]
    },
    {
      "origin": {
        "code": "ORY",
        "name": "Paris, Francia (ORY-Orly)"
      },
      "destination": {
        "code": "EZE",
        "name": "Buenos Aires, Argentina (EZE-Ministro Pistarini Intl.)"
      },
      "departure_date": "2018-12-16",
      "options": [
        {
          "id": "6855463430059123414",
          "departure_date": "2018-12-16",
          "departure_time": "06:55",
          "arrival_date": "2018-12-17",
          "arrival_time": "17:45",
          "duration": "38:50",
          "legs": [
            {
              "origin": {
                "code": "ORY",
                "name": "Paris, Francia (ORY-Orly)"
              },
              "destination": {
                "code": "BCN",
                "name": "Barcelona, Spain (BCN-Barcelona Intl.)"
              },
              "departure_date": "2018-12-16",
              "departure_time": "06:55",
              "arrival_date": "2018-12-16",
              "arrival_time": "08:30",
              "marketing_carrier": {
                "code": "IB",
                "name": "Iberia"
              },
              "operating_carrier": {
                "code": "VY",
                "name": "Vueling"
              },
              "duration": "01:35",
              "flight_number": "5746",
              "aircraft_type": "Airbus A320-100/200",
              "cabin_type": {
                "code": "O",
                "name": "Economy",
                "quantity": 4
              }
            },
            {
              "origin": {
                "code": "BCN",
                "name": "Barcelona, Spain (BCN-Barcelona Intl.)"
              },
              "destination": {
                "code": "EZE",
                "name": "Buenos Aires, Argentina (EZE-Ministro Pistarini Intl.)"
              },
              "departure_date": "2018-12-17",
              "departure_time": "08:10",
              "arrival_date": "2018-12-17",
              "arrival_time": "17:45",
              "marketing_carrier": {
                "code": "IB",
                "name": "Iberia"
              },
              "operating_carrier": {
                "code": "IB",
                "name": "Iberia"
              },
              "duration": "13:35",
              "flight_number": "2603",
              "aircraft_type": "Airbus A330-200",
              "cabin_type": {
                "code": "L",
                "name": "Economy",
                "quantity": 9
              }
            }
          ],
          "baggage_allowance": [
            
          ]
        }
      ]
    }
  ],
  "price": {
    "adults": {
      "fare": 70640,
      "quantity": 2
    },
    "taxes": 15642.8,
    "charges": 8355.68,
    "total": 94638.47,
    "currency": "ARS"
  },
  "validating_carrier": {
    "code": "IB",
    "name": "Iberia"
  },
  "route_type": "INTERNATIONAL",
  "flight_type": "ROUND_TRIP"
}

404