---
title: "Search flights — full connector fleet, counts as 1 search"
method: POST
path: "/flights/search"
tags: ["flights"]
---

# Search flights — full connector fleet, counts as 1 search

`POST /flights/search`

## Request

- Base URL: `https://letsfg.co/developers/api/v1`
- URL: `https://letsfg.co/developers/api/v1/flights/search`
- Auth: API key in header `X-API-Key`

Searches every airline and the major booking sites and returns live flight offers. Requires an API key and a connected Revolut payment method; the first 200 searches after every flight booking are free, and a search counts only when it returns offers. Response time: 60–90 seconds.

For faster price discovery across many destinations, use POST /flights/discover (one search counted for up to 100 destinations, 2–5 seconds). For a non-blocking flow with a loading state, use POST /flights/search/async.

## Request body

- FlightSearchRequest
  - `origin` string, required: IATA departure code (e.g. LON, JFK)
  - `destination` string, required: IATA arrival code (e.g. BCN, LAX)
  - `date_from` string, date, required
  - `date_to` string, date
  - `return_from` string, date
  - `return_to` string, date
  - `adults` integer
  - `children` integer
  - `infants` integer
  - `cabin_class` 'M' | 'W' | 'C' | 'F'
  - `max_stopovers` integer
  - `currency` string
  - `locale` string
  - `limit` integer
  - `sort` string
  - `departure_time_from` string
  - `departure_time_to` string
  - `provider_filters` object
  - `min_hours_at_destination` integer, nullable: Same-day round trip only (return_from equal to date_from): minimum hours between outbound landing and return departure. Offers with a shorter layover are excluded.
  - `max_return_hour` integer, nullable: Same-day round trip only (return_from equal to date_from): latest local hour the return may land on the calendar day after departure (e.g. 2 = home by 2 AM) before it is filtered out. Defaults to 2 so a real same-day round trip whose return crosses midnight by an hour or two is not silently reported as zero results. Same-day evening landings (before midnight) are always kept regardless of this value. Pass 0 to require a strict same-calendar-day return.

## Response `200`

Flight search results.

- FlightSearchResponse
  - `passenger_ids` string[]
  - `total_results` integer
  - `offers` object[]

---

[API](https://skmtc.dev/letsfg/apis/letsfg-public-developer-api.md) · [All operations](https://skmtc.dev/letsfg/apis/letsfg-public-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsfg/apis/letsfg-public-developer-api/revisions/516ab6ba1d2e?raw)