---
title: "Sandbox: search flights — free, fake data, same schema"
method: POST
path: "/sandbox/flights/search"
tags: ["sandbox"]
---

# Sandbox: search flights — free, fake data, same schema

`POST /sandbox/flights/search`

## Request

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

Identical request/response schema to POST /flights/search. Returns realistic fake offers instantly. No credits charged. Use to build and test your integration before going live.

## 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`

Fake flight results in production schema.

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