{"uid":"cap_fBDps1DEW8Bg72hQgo9Xx","slug":"stabletravel-flight-lookup-by-ident-2db66f21","name":"StableTravel Flight Lookup by Ident","description":"Get flight information by ident (designator, registration, or fa_flight_id)","url":"https://stabletravel.dev/api/flightaware/flights/JA803X","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"end":{"type":"string","description":"End date/time (ISO 8601)"},"start":{"type":"string","description":"Start date/time (ISO 8601)"},"cursor":{"type":"string","description":"Opaque cursor for pagination"},"max_pages":{"type":"number","description":"Maximum number of pages to fetch"},"ident_type":{"enum":["fa_flight_id","designator","registration"],"type":"string","description":"Type of flight identifier"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["flights"],"properties":{"links":{"anyOf":[{"type":"object","properties":{"next":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"flights":{"type":"array","items":{"type":"object","properties":{"type":{"anyOf":[{"enum":["Airline","General_Aviation","Cargo"],"type":"string"},{"type":"null"}]},"ident":{"anyOf":[{"type":"string"},{"type":"null"}]},"route":{"anyOf":[{"type":"string"},{"type":"null"}]},"origin":{"anyOf":[{"type":"object","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"code":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"code_lid":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]},"code_iata":{"anyOf":[{"type":"string"},{"type":"null"}]},"code_icao":{"anyOf":[{"type":"string"},{"type":"null"}]},"airport_info_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"blocked":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"diverted":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"operator":{"anyOf":[{"type":"string"},{"type":"null"}]},"actual_in":{"anyOf":[{"type":"string"},{"type":"null"}]},"actual_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"atc_ident":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelled":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"filed_ete":{"anyOf":[{"type":"number"},{"type":"null"}]},"actual_off":{"anyOf":[{"type":"string"},{"type":"null"}]},"actual_out":{"anyOf":[{"type":"string"},{"type":"null"}]},"codeshares":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"ident_iata":{"anyOf":[{"type":"string"},{"type":"null"}]},"ident_icao":{"anyOf":[{"type":"string"},{"type":"null"}]},"destination":{"anyOf":[{"type":"object","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"code":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"code_lid":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]},"code_iata":{"anyOf":[{"type":"string"},{"type":"null"}]},"code_icao":{"anyOf":[{"type":"string"},{"type":"null"}]},"airport_info_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"gate_origin":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimated_in":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimated_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"fa_flight_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"registration":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduled_in":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduled_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"aircraft_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"arrival_delay":{"anyOf":[{"type":"number"},{"type":"null"}]},"baggage_claim":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimated_off":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimated_out":{"anyOf":[{"type":"string"},{"type":"null"}]},"flight_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"operator_iata":{"anyOf":[{"type":"string"},{"type":"null"}]},"operator_icao":{"anyOf":[{"type":"string"},{"type":"null"}]},"position_only":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"scheduled_off":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduled_out":{"anyOf":[{"type":"string"},{"type":"null"}]},"filed_airspeed":{"anyOf":[{"type":"number"},{"type":"null"}]},"filed_altitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"route_distance":{"anyOf":[{"type":"number"},{"type":"null"}]},"codeshares_iata":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"departure_delay":{"anyOf":[{"type":"number"},{"type":"null"}]},"terminal_origin":{"anyOf":[{"type":"string"},{"type":"null"}]},"gate_destination":{"anyOf":[{"type":"string"},{"type":"null"}]},"progress_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"seats_cabin_coach":{"anyOf":[{"type":"number"},{"type":"null"}]},"seats_cabin_first":{"anyOf":[{"type":"number"},{"type":"null"}]},"actual_arrival_time":{"anyOf":[{"type":"string"},{"type":"null"}]},"inbound_fa_flight_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"seats_cabin_business":{"anyOf":[{"type":"number"},{"type":"null"}]},"terminal_destination":{"anyOf":[{"type":"string"},{"type":"null"}]},"actual_departure_time":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimated_arrival_time":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduled_arrival_time":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimated_departure_time":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduled_departure_time":{"anyOf":[{"type":"string"},{"type":"null"}]},"foresight_predictions_available":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false}},"num_pages":{"type":"number"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CVxPHmFucfXwtVjQ18-si","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves detailed flight information for a specific aircraft or flight using a designator, registration number, or FlightAware flight ID","exampleAgentPrompt":"Can you pull up all the recent flights for the aircraft with registration JA803X using FlightAware data — I want to see the routes, origin and destination airports, and flight types for the past week?","exampleUseCases":[{"title":"Track private aircraft by tail number","prompt":"I need to see all the flights made by the aircraft with registration N12345 over the last 30 days — can you pull the routes, airports, and departure times from FlightAware?"},{"title":"Verify airline flight history by designator","prompt":"Can you look up flight history for the designator UAL789 between January 10th and January 20th this year? I want to see where it flew and what type of flights those were."},{"title":"Fetch cargo flight details by FlightAware ID","prompt":"I have a FlightAware flight ID — FXE1234-1700000000-airline-1234 — can you fetch the full flight details for it, including the origin, destination, and route?"}],"resultDescription":"Returns a paginated list of flight objects matching the given ident, each containing: flight ident, flight type (Airline, General Aviation, Cargo), route string, origin and destination airport details (ICAO/IATA/LID codes, city, name, timezone, info URL), scheduled and actual departure/arrival times, and a pagination links object for fetching additional pages.","failureModes":["Unknown or invalid ident returns empty flights array","Unsupported ident_type enum value causes validation error","Date range with no matching flights returns empty array","Malformed ISO 8601 date strings cause parameter rejection","Rate limits or payment failures return 402 Payment Required","Pagination cursor expiry causes loss of position in result set"],"whenToPreferThis":"Use this endpoint when you have a specific aircraft or flight identifier (tail number, airline flight code, or FlightAware fa_flight_id) and need historical or scheduled flight data including route, airport, and timing details. Prefer this over generic flight search when the exact ident is already known. Ideal for tracking a specific aircraft's movements, verifying a flight's route, or building per-flight audit trails. Not suited for broad airport departure/arrival board queries or searching flights by city-pair without a known ident.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:58:35.363Z","isFirstParty":false}