---
title: "Search flights"
method: POST
path: "/api/v1/flights/search"
tags: ["Flights"]
---

# Search flights

`POST /api/v1/flights/search`

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.

## Request body

- FlightSearchRequest
  - `origin` string, required — IATA airport or city code (e.g. LHR, LON, JFK)
  - `destination` string, required — IATA airport or city code
  - `date_from` string, date, required — Departure date (YYYY-MM-DD)
  - `date_to` string, date — Return date for round-trip (YYYY-MM-DD). Omit for one-way.
  - `adults` integer — Number of adult passengers
  - `children` integer — Number of children (2-11 years)
  - `cabin` 'M' | 'W' | 'C' | 'F' — Cabin class: M=economy, W=premium economy, C=business, F=first
  - `max_stops` integer — Maximum stopovers per direction
  - `currency` string — 3-letter currency code
  - `limit` integer — Maximum number of results
  - `sort` 'price' | 'duration'

## Response `200`

Search results

- FlightSearchResponse
  - `search_id` string — Unique search identifier
  - `passenger_ids` string[] — Passenger IDs to use when booking (e.g. pas_0, pas_1)
  - `total_results` integer — Total number of matching offers
  - `offers` FlightOffer[]
    - `id` string — Offer ID (use for unlock/book)
    - `price` number, float — Total price for all passengers
    - `currency` string
    - `airlines` string[] — Airlines operating the flights
    - `owner_airline` string — Primary operating airline
    - `route` string — Route summary (e.g. STN → BCN)
    - `duration_seconds` integer — Total journey duration in seconds
    - `stopovers` integer — Number of stops
    - `outbound` FlightRoute
      - `segments` FlightSegment[]
        - `airline` string
        - `flight_no` string
        - `origin` string
        - `destination` string
        - `departure` string, date-time
        - `arrival` string, date-time
        - `duration_seconds` integer
        - `cabin` string
      - `total_duration_seconds` integer
      - `stopovers` integer
      - `route_str` string — Human-readable route (e.g. LHR → BCN)
    - `inbound` FlightRoute
      - `segments` FlightSegment[]
        - `airline` string
        - `flight_no` string
        - `origin` string
        - `destination` string
        - `departure` string, date-time
        - `arrival` string, date-time
        - `duration_seconds` integer
        - `cabin` string
      - `total_duration_seconds` integer
      - `stopovers` integer
      - `route_str` string — Human-readable route (e.g. LHR → BCN)
    - `conditions` object
      - `refund_before_departure` 'allowed' | 'allowed_with_fee' | 'not_allowed'
      - `change_before_departure` 'allowed' | 'allowed_with_fee' | 'not_allowed'
    - `is_locked` boolean — Whether this offer has been unlocked
    - `source` string — Data source (e.g. ryanair, amadeus, duffel)

## Other responses

- `401` — Invalid or missing API key
- `422` — Invalid request (bad IATA code, date in past, etc.)

---

[API](https://skmtc.dev/letsfg/apis/letsfg-api.md) · [All operations](https://skmtc.dev/letsfg/apis/letsfg-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/letsfg/letsfg-api/revisions/2cdf41994925/schema)