v1

latestOpenAPI 3.0.32026-07-26630183.2 KB
Flights

Search

get/flights-api/availability

Query parameters

sitestring required

Refers to the country code and must be filled in with two alphabetical characters. The value must correspond to the POS associated with the API credentials.

fromstring required

Refers to the origin of the flight and must be filled in with the IATA code of the airport or city, containing three alphabetical digits.

tostring required

Refers to the flight destination and must be filled in with the IATA code of the airport or city, containing three alphabetical digits.

departure_datestring date required

Refers to the flight departure date and must be filled in the format YYYY-MM-DD.

return_datestring date

Refers to the flight's return date and must be filled in the format YYYY-MM-DD. This parameter is only valid for round-trip flights.

adultsinteger required

Refers to the number of adults on the flight and must be filled with a maximum of 9 adults, provided there are no other passengers. If there are children and infants on the flight, the total number of passengers must be 9, including adults, children, and infants.

childreninteger

Refers to the number of children on the flight, aged between 2 and 11 years old, and must be filled in with a total of 9 passengers including adults, children and infants.

infantsinteger

This field refers to the number of infants on the flight, aged between 0 and 23 months, and must be filled in with a number equal to or less than the number of adults, totaling 9 passengers including adults, children and infants.

currencystring

This field determines in which currency the flight fare values ​​will be returned in the response.

cabin_type'Business' | 'Firstclass' | 'Premium_business' | 'Premium_firstclass' | 'Premium_economy' | 'Economy'

Allows filtering results by flight cabin type.

offsetinteger

This field refers to the number of records that are ignored before starting to return results, that is, if a certain result displays 200 flights and I want to access from the 10th result, I send this parameter with 10 and thus the 11th record becomes the first of the displayed result, that is, it can be used for pagination of the result.

limitinteger

Limits the number of flights returned, when not sent, 20 results are returned by default.

group_bystring

Refers to grouping the received result. Can be filled with: No sending or 'none': no ​​grouping. 'flexible_penalty': groups by final price, validating carrier, and baggage conditions.

order_bystring

This field determines the criteria used to sort the search results. When left blank by default, the ordering is from lowest to highest. The following are the possible values; all can be followed by '_ascending' or '_descending', with a few exceptions: - suitable ('_ascending' only, recommended order) - total_price - stopscount - price (base price) - duration - airline - departure - arrival - fare_minus_discount - cross_selling_price - cross_selling_total_price - cabin_purity ('_descending' only).

pricestring

When sending this field with the value 'raw', the returned values ​​will not be rounded.

total_price_rangestring

Delimits the total price returned in the response, example: 1000-2500.

stopsstring

Refers to the number of stops on the flight. You can submit more than one option by separating them with commas. The allowed values ​​are: - 'NONE' (direct flights) - 'ONE' (flights with one stop) - 'MORE_THAN_ONE' (flights with more than one stop).

airlinesstring

Delimits the airlines that will be returned in the search results, must be filled in with the airline's IATA code.

alliancesstring

This field allows you to search by airline alliance. An airline alliance is when two or more airlines cooperate so that travelers can make codeshare connections within their countries. Multiple options are allowed, separated by commas. The allowed values ​​are: - 'OW': One World - 'SA': Star Alliance - 'ST': Sky Team.

outbound_time_rangestring

Defines the times of outbound flights within a given range. Example: 7:00-8:00.

inbound_time_rangestring

Defines the return flight times within a specific range. Parameter valid only for roundtrip flights.

unique_airlinestring

Specifies that the roundtrip flight will be the same airline when set to 'true'. When set to 'false' or not set, different airlines may be used. This parameter is only valid for roundtrip flights.

unique_outbound_airportstring

When set to 'true', both the first departure and last arrival must be at the same airport. This parameter is valid only for roundtrip flights.

outbound_duration_rangestring

Refers to the duration interval in minutes of the outbound flight, the format is %d-%d. Ex.: 0-540.

inbound_duration_rangestring

Refers to the duration interval in minutes of the return flight, the format is %d-%d. Ex.: 0-540. Parameter valid only for round-trip flights.

outbound_airportsstring

This field delimits the search result to a specific airport on the way.

inbound_airportsstring

This field limits the search results to a specific airport on the return journey. This parameter is valid only for roundtrip flights.

outbound_arrival_time_rangestring

This field delimits the search results by filtering by the arrival time of flights on the outbound leg. Ex.: 16:00-16:30.

Response

OK