{"uid":"cap_0oQ7Lh3IFHRZXnTV68_Sh","slug":"flightaware-58bacfc0","name":"FlightAware Flight Search with Positions","description":"Search flights with position data.","url":"https://stabletravel.dev/api/flightaware/flights/search/positions","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","required":["query"],"properties":{"query":{"type":"string","description":"Search query string"},"filter":{"enum":["airborne","grounded"],"type":"string","description":"Filter by flight state"},"unique_flights":{"type":"boolean","description":"Return only unique flights"}},"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"}]},"last_position":{"anyOf":[{"type":"object","properties":{"heading":{"anyOf":[{"type":"number"},{"type":"null"}]},"altitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]},"groundspeed":{"anyOf":[{"type":"number"},{"type":"null"}]},"update_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"fa_flight_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"altitude_change":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},{"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":{"type":"json","example":{"flights":[{"type":"Airline","ident":"AAL100","origin":{"city":"New York","code":"KJFK","name":"John F. Kennedy International","code_iata":"JFK","code_icao":"KJFK"},"status":"Scheduled","operator":"AAL","ident_iata":"AA100","ident_icao":"AAL100","destination":{"city":"Los Angeles","code":"KLAX","name":"Los Angeles International","code_iata":"LAX","code_icao":"KLAX"},"fa_flight_id":"AAL100-1733068800-airline-0001","scheduled_in":"2026-12-01T19:00:00Z","aircraft_type":"B738","flight_number":"100","last_position":{"heading":270,"altitude":350,"latitude":40.5,"longitude":-100.1,"timestamp":"2026-12-01T15:00:00Z","groundspeed":480,"update_type":"A","fa_flight_id":"AAL100-1733068800-airline-0001","altitude_change":"C"},"operator_iata":"AA","operator_icao":"AAL","scheduled_out":"2026-12-01T13:00:00Z"}],"num_pages":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HAx2ufl7GxF38F3eqRBCS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for flights matching a query string and return real-time position data including location, status, origin, destination, and flight type.","exampleAgentPrompt":"Search FlightAware for all airborne United Airlines flights right now and show me their current positions, statuses, and routes — use 'United' as the query and filter to airborne only.","exampleUseCases":null,"resultDescription":"Returns an array of flight objects each containing flight identifier, type (Airline/General_Aviation/Cargo), origin and destination airports (with IATA/ICAO codes, city, timezone), current status, route string, position data, and a pagination link for additional results.","failureModes":["Missing required 'query' parameter returns validation error","Invalid filter value (not 'airborne' or 'grounded') returns 400 error","Query matches no flights returns empty flights array","FlightAware upstream timeout returns 503 or gateway error","Payment of 0.1 USDC not provided returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to search for multiple flights matching a keyword, airline, callsign, or route pattern and want real-time position data included in the results. Prefer this over the airport-specific flights endpoint when you don't have a specific airport code but have a flight identifier, airline name, or route pattern. Choose this over the track endpoint when you want to discover flights first before drilling into a specific flight's full track.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:58:29.828Z","isFirstParty":false}