sandbox

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

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.

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

Request body

originstring required

IATA departure code (e.g. LON, JFK)

destinationstring required

IATA arrival code (e.g. BCN, LAX)

date_fromstring date required
date_tostring date
return_fromstring date
return_tostring date
adultsinteger
childreninteger
infantsinteger
cabin_class'M' | 'W' | 'C' | 'F'
max_stopoversinteger
currencystring
localestring
limitinteger
sortstring
departure_time_fromstring
departure_time_tostring
provider_filtersobject
min_hours_at_destinationinteger 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_hourinteger 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.

Example request

{
  "origin": "LON",
  "destination": "BCN",
  "date_from": "2026-06-15",
  "adults": 1,
  "currency": "EUR"
}

Response

Fake flight results in production schema.

passenger_idsstring[]
total_resultsinteger
offersobject[]

Changes

No recorded changes to this operation across all 1 revision of this API.