---
title: "Full search for N destinations in parallel — 1 search counted per destination with offers"
method: POST
path: "/flights/multi-search"
tags: ["flights"]
---

# Full search for N destinations in parallel — 1 search counted per destination with offers

`POST /flights/multi-search`

## Request

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

Fires a complete connector search for each destination in parallel and returns full results in one response. Each destination that returns offers counts as one search — same as calling POST /flights/search N times. Max 10 destinations.

For discovery use cases (ranking many destinations cheaply), use POST /flights/discover instead (one search counted for up to 100 destinations).

## Request body

- MultiSearchRequest
  - `origin` string, required: Departure IATA code.
  - `destinations` string[], required: 1–10 destination IATA codes. Each runs a full search and counts as one search against the allowance - only if it returns offers.
  - `date_from` string, date, required
  - `return_from` string, date
  - `adults` integer
  - `currency` string
  - `cabin_class` 'M' | 'W' | 'C' | 'F'
  - `max_stopovers` integer
  - `departure_time_from` string
  - `departure_time_to` string

## Response `200`

Full search results for all destinations.

- MultiSearchResponse
  - `origin` string
  - `results` object[]
    - `destination` string
    - `status` 'ok' | 'error' | 'insufficient_balance'
    - `charged` boolean
    - `total_results` integer
    - `cheapest_price` number, nullable
    - `currency` string
    - `offers` object[]
  - `summary` object
    - `requested` integer
    - `completed` integer
    - `charged_searches` integer
    - `pricing_note` string

## Other responses

- `402`: Prepaid balance empty or payment method missing.

---

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