API referenceFlights
Search flights
Serves from the Redis cache when fresh. Concurrent identical searches are coalesced into a single upstream call. When the flight number operates more than one leg that day, pass `origin` (and optionally `destination`) to pick one; without a selector the provider default is returned and every leg is listed under `alternates`.
Serves from the Redis cache when fresh. Concurrent identical searches are coalesced into a single upstream call. When the flight number operates more than one leg that day, pass origin (and optionally destination) to pick one; without a selector the provider default is returned and every leg is listed under alternates.
Authorization
apiKey x-api-key<token>
Your FlightByte API key. Request one at https://flightbyte.dev/get-api-key.
In: header
Query Parameters
carrier*string
Airline IATA/ICAO code.
flightNumber*string
date*string
Local departure date at the origin.
origin?string
Departure airport, when the flight number operates several legs that day. IATA or the upstream code; both resolve to the same leg.
destination?string
Arrival airport, to narrow further.
flightId?string
Provider flight id from a previous response's alternates. Exact match.
refresh?string
Bypass the cache.
Response Body
application/json
curl -X GET "https://example.com/v1/flights/search?carrier=TK&flightNumber=1848&date=2026-09-08"{ "flightKey": "TK1848:2026-09-08", "carrierCode": "TK", "flightNumber": "1848", "date": "2026-09-08", "providerFlightId": "1407084032", "fetchedAt": "2026-09-09T13:20:00.000Z", "carrier": { "iata": "TK", "icao": "THY", "name": "Turkish Airlines" }, "operatedBy": "AnadoluJet", "codeshares": [ { "carrier": "A3", "name": "Aegean Airlines", "flightNumber": "3160" } ], "departure": { "airport": { "iata": "IST", "icao": "LTFM", "code": {}, "name": "Istanbul Airport", "city": "Istanbul", "state": "", "country": { "code": "TR", "name": "Turkey", "emoji": "🇹🇷", "flagSvg": "https://api.example.com/v1/flags/tr.svg", "flagSvgSquare": "https://api.example.com/v1/flags/tr.svg?shape=1x1" }, "timezone": "Europe/Istanbul" }, "terminal": "M", "gate": "A11", "baggage": "16", "times": { "scheduledGate": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "estimatedGate": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "actualGate": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "scheduledRunway": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "estimatedRunway": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "actualRunway": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" } }, "bestTimeUtc": {}, "delayMinutes": {} }, "arrival": { "airport": { "iata": "IST", "icao": "LTFM", "code": {}, "name": "Istanbul Airport", "city": "Istanbul", "state": "", "country": { "code": "TR", "name": "Turkey", "emoji": "🇹🇷", "flagSvg": "https://api.example.com/v1/flags/tr.svg", "flagSvgSquare": "https://api.example.com/v1/flags/tr.svg?shape=1x1" }, "timezone": "Europe/Istanbul" }, "terminal": "M", "gate": "A11", "baggage": "16", "times": { "scheduledGate": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "estimatedGate": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "actualGate": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "scheduledRunway": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "estimatedRunway": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "actualRunway": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" } }, "bestTimeUtc": {}, "delayMinutes": {} }, "diverted": { "airport": { "iata": "IST", "icao": "LTFM", "code": {}, "name": "Istanbul Airport", "city": "Istanbul", "state": "", "country": { "code": "TR", "name": "Turkey", "emoji": "🇹🇷", "flagSvg": "https://api.example.com/v1/flags/tr.svg", "flagSvgSquare": "https://api.example.com/v1/flags/tr.svg?shape=1x1" }, "timezone": "Europe/Istanbul" }, "terminal": "M", "gate": "A11", "baggage": "16", "times": { "scheduledGate": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "estimatedGate": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "actualGate": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "scheduledRunway": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "estimatedRunway": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" }, "actualRunway": { "utc": "2026-09-08T09:10:00.000Z", "local": "2026-09-08T12:10:00.000", "timezone": "EEST" } }, "bestTimeUtc": {}, "delayMinutes": {} }, "status": { "code": "L", "label": "Arrived", "description": "On time", "color": "green", "phase": "scheduled", "delayed": true, "cancelled": true, "diverted": true, "departureGateDelayMinutes": {}, "arrivalGateDelayMinutes": {} }, "equipment": { "tailNumber": "TC-LTP", "iata": "32Q", "name": "Airbus A321neo", "source": "Actual" }, "duration": { "scheduledMinutes": {}, "estimatedMinutes": {}, "actualMinutes": {} }, "timeline": [ { "occurredAt": "2026-09-09T10:38:16.000Z", "title": "Time Adjustment", "source": "Airline", "events": [ "Actual Gate Arrival changed to 13:35" ] } ], "alternates": [ { "providerFlightId": "1407278900", "carrier": "AJA", "departureIata": "SAW", "arrivalIata": "AMS", "scheduledDepartureLocal": "08:45", "scheduledArrivalLocal": "11:30", "selected": true } ], "fingerprint": "9f2b..."}