Sign in

v15

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-0171615.2 KB
Flights

Search flights

Search hundreds of airlines for flights. Free and unlimited. Results include price, airlines, duration, stopovers, and booking conditions. City codes (LON, NYC, PAR) automatically expand to all airports in that city.

post/api/v1/flights/search

Request body

originstring required

IATA airport or city code (e.g. LHR, LON, JFK)

destinationstring required

IATA airport or city code

date_fromstring date required

Departure date (YYYY-MM-DD)

date_tostring date

Return date for round-trip (YYYY-MM-DD). Omit for one-way.

adultsinteger

Number of adult passengers

childreninteger

Number of children (2-11 years)

cabin'M' | 'W' | 'C' | 'F'

Cabin class: M=economy, W=premium economy, C=business, F=first

max_stopsinteger

Maximum stopovers per direction

currencystring

3-letter currency code

limitinteger

Maximum number of results

sort'price' | 'duration'

Example request

{
  "origin": "LHR",
  "destination": "JFK",
  "date_from": "2026-04-15",
  "currency": "EUR"
}

Response

Search results

search_idstring

Unique search identifier

passenger_idsstring[]

Passenger IDs to use when booking (e.g. pas_0, pas_1)

total_resultsinteger

Total number of matching offers

Example response

{
  "offers": [
    {
      "id": "off_abc123",
      "price": 189.5,
      "currency": "EUR",
      "airlines": [
        "Ryanair"
      ]
    }
  ]
}