# Search flights (/docs/api-reference/flights/search)

`POST /v1/flights/search`

Searches flight itineraries and the fares bookable on them.

Send one slice per flight (one for one-way, two for a return, more for a multi-city trip) and every passenger;
at least one passenger must be an `adult`, and children and infants need an `age`. Optional
`filters`: `maxStops`, `preferredAirlines` and `excludedAirlines` select itineraries;
`refundableOnly` and `maxPrice` select fares, and an itinerary left without a fare is not returned.
The body rejects an unknown field at every level, and the route takes no query parameters.
            
Returns `{ items, pagination }`. Each item is one itinerary, the same flights sold by the same airline, with
its fares as `offers`, cheapest first; items are ordered by their cheapest fare, then total duration.
`page` and `limit` (defaults 1 and 10, `limit` at most 100) page through itineraries, and
`pagination.totalCount` counts them. Each page runs a new airline search, so fares can change between pages.
            
An item's `id` is valid only within this response and cannot be ordered; quote and order an offer's
`publicId` before its `details.expiresAt`. Prices are for all passengers, in `currency` or the API
key's currency, and are indicative.
            
Errors: an invalid or unknown field, or a query parameter, 400 / 10001; an unsupported `currency`
404 / 10004.

## Request body

- `application/json`: `FlightSearchRequest`
- `text/json`: `FlightSearchRequest`
- `application/*+json`: `FlightSearchRequest`

## Responses

### 200

OK

- `text/plain`: `FlightSearchResult`
- `application/json`: `FlightSearchResult`
- `text/json`: `FlightSearchResult`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.