Search flights by route and date

Search priced flight itineraries for a route and a date. `origin`, `destination` and `departureDate` are the only required fields — two three-letter airport codes and a YYYY-MM-DD date — and every itinerary comes back with its price, its carriers, its segments with full airport names and times, its stop count and its layovers. `price` is `{amount, currency, formatted}` — a number, a currency code and a display string — and `priceType` says what the number covers: `"one_way"` or `"round_trip_total"`. Pass `currency` to price results in a specific one. Every itinerary measured was priced: 48 of 48 on JFK→LHR, 18 of 18 on DUB→STN, 18 of 18 on a LAX→NRT round trip, 44 of 44 on a nonstop business-class JFK→LHR search. **A round trip prices the whole trip but does not itemize the return.** Pass `returnDate` and `priceType` comes back `"round_trip_total"` — the amount covers both directions — while **`inbound` is `null`**. Each outbound option is priced against its cheapest matching return, and that return flight is not described. The total is real; the return leg's times are not in the response. Measured on a LAX→NRT round trip for two adults: 18 itineraries, every one priced, every `inbound` null. For a one-way search, omit `returnDate` — there is no implicit return window. **Read `stops`, not `segments.length`.** A one-stop itinerary can still carry a single `segments[]` entry — measured on a JFK→LHR option that came back with one segment, `stops: 1` and a 120-minute layover in Dublin. `stops` is the authoritative count and `layovers[]` carries the detail as `{airportCode, airportName, city, durationMinutes}`. Deriving the stop count from the segment list will report that itinerary as nonstop. **No matches is a 200, not an error.** A route and filter combination with nothing available returns `itineraries: []`, `itineraryCount: 0` and a note saying so in words — "No itineraries were found for these dates and filters." There is nothing to retry and nothing to mistake for a failure. Measured on a short-haul route with `nonstopOnly` and `cabinClass: "first"`. Every response carries `scrapedAt`, an ISO timestamp for when the fares were read. Fares move constantly, so use the response's own timestamp rather than the time you happened to look at it — that is what tells a caller how old the number in front of them is. Coverage spans full-service and low-cost carriers alike, and you can see it in the results rather than take it on trust: one measured DUB→STN search returned Ryanair, Ryanair UK and Turkish Airlines side by side, with fares from $22, and a JFK→LHR search returned 48 priced itineraries in a single call. Filters narrow the search rather than the response: `cabinClass`, `nonstopOnly`, `adults`/`children`/`infants` and `currency` are all applied before the fares are read, and every one of them is echoed back on the response so a result set is self-describing. Billing: 1 credit per request, reported as `pagesFetched`. There is no paging. Measured on 17 September 2026, three runs each: JFK→LHR answered in 1.34-2.84s with 48 itineraries, DUB→STN in 1.67-1.86s with 18, a LAX→NRT round trip for two adults in 1.68-2.76s with 18, and a nonstop business-class JFK→LHR search in 1.78s with 44.

curl -X POST "https://api.fetchlayer.dev/flights/search" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"origin":"JFK","destination":"LHR","departureDate":"2026-10-15"}'

{
  "transport": "flight-search",
  "notes": [],
  "pagesFetched": 1,
  "origin": "JFK",
  "destination": "LHR",
  "departureDate": "2026-10-15",
  "returnDate": null,
  "tripType": "one_way",
  "adults": 1,
  "children": 0,
  "infants": 0,
  "cabinClass": "economy",
  "nonstopOnly": false,
  "currency": "USD",
  "locale": "en",
  "scrapedAt": "2026-09-17T11:59:41.161Z",
  "itineraryCount": 48,
  "itineraries": [
    {
      "id": "ul84o9",
      "outbound": {
        "segments": [
          {
            "airline": "British Airways",
            "departureAirportCode": "JFK",
            "departureAirportName": "John F. Kennedy International Airport",
            "arrivalAirportCode": "LHR",
            "arrivalAirportName": "Heathrow Airport",
            "departureTime": "7:50 AM",
            "arrivalTime": "7:45 PM",
            "departureDate": "2026-10-15",
            "arrivalDate": "2026-10-15"
          }
        ],
        "stops": 0,
        "layovers": [],
        "durationMinutes": 415,
        "airlines": [
          "British Airways"
        ]
      },
      "inbound": null,
      "price": {
        "amount": 295,
        "currency": "USD",
        "formatted": "295"
      },
      "priceType": "one_way",
      "airlines": [
        "British Airways"
      ]
    },
    {
      "id": "zmpos7",
      "outbound": {
        "segments": [
          {
            "airline": "Aer Lingus",
            "departureAirportCode": "JFK",
            "departureAirportName": "John F. Kennedy International Airport",
            "arrivalAirportCode": "LHR",
            "arrivalAirportName": "Heathrow Airport",
            "departureTime": "4:55 PM",
            "arrivalTime": "8:05 AM",
            "departureDate": "2026-10-15",
            "arrivalDate": "2026-10-16"
          }
        ],
        "stops": 1,
        "layovers": [
          {
            "airportCode": "DUB",
            "airportName": "Dublin Airport",
            "city": "Dublin",
            "durationMinutes": 120
          }
        ],
        "durationMinutes": 610,
        "airlines": [
          "Aer Lingus"
        ]
      },
      "inbound": null,
      "price": {
        "amount": 295,
        "currency": "USD",
        "formatted": "295"
      },
      "priceType": "one_way",
      "airlines": [
        "Aer Lingus"
      ]
    }
  ]
}

{
  "error": "Invalid API key"
}