API Reference

Search

get
https://api-dev.despegar.com/v3/flights-api/availability
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Next step: Booking Flow (Prebook)

If you want to access the booking service, use the field from the response: choice_id

ℹ️

For a detailed flow diagram of this service, see: Guides-Flights

⏱️

The TTL (Time To Live) for flight search results is 25 seconds.

Query Params
string
required
length between 2 and 2

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.

string
required
length between 3 and 3

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.

string
required
length between 3 and 3

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

date
required

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

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.

integer
required
≥ 1

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.

integer
≥ 0
Defaults to 0

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.

integer
≥ 0
Defaults to 0

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.

string
length between 3 and 3

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

string
enum

Allows filtering results by flight cabin type.

Allowed:
integer
≥ 0
Defaults to 0

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.

integer
≥ 1

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

string

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.

string

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).

string

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

string

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

string

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).

string

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

string

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.

string

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

string

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

string

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.

string

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.

string

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

string

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.

string

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

string

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

string

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

Responses

Updated 21 days ago

Did this page help you?
Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 21 days ago

Did this page help you?