{"uid":"cap_ihIVd0b1ZTW4D5EET4niu","slug":"stabletravel-positions-a78525f3","name":"FlightAware Positions Search","description":"Search for flights with position data","url":"https://stabletravel.dev/api/flightaware/flights/search/positions?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","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"}}},"responseSchema":{"type":"object","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},"example":{"request":{"query":"United Airlines","filter":"airborne","unique_flights":true},"response":{"links":{"next":"/flights/search/positions?cursor=d6836370c668294"},"num_pages":1,"positions":[{"heading":0,"altitude":112,"latitude":33.01709,"longitude":-114.23932,"timestamp":"2026-03-29T23:58:28Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01666,"longitude":-114.23923,"timestamp":"2026-03-30T00:03:27Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01664,"longitude":-114.23921,"timestamp":"2026-03-30T00:03:44Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01666,"longitude":-114.23921,"timestamp":"2026-03-30T00:04:15Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01688,"longitude":-114.23927,"timestamp":"2026-03-30T00:06:04Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01681,"longitude":-114.23925,"timestamp":"2026-03-30T00:06:52Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01681,"longitude":-114.23927,"timestamp":"2026-03-30T00:07:31Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01675,"longitude":-114.23932,"timestamp":"2026-03-30T00:08:23Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01668,"longitude":-114.23934,"timestamp":"2026-03-30T00:08:55Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01666,"longitude":-114.23934,"timestamp":"2026-03-30T00:09:30Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01673,"longitude":-114.23938,"timestamp":"2026-03-30T00:10:24Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01681,"longitude":-114.2394,"timestamp":"2026-03-30T00:11:20Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01683,"longitude":-114.23938,"timestamp":"2026-03-30T00:11:51Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":180,"altitude":112,"latitude":33.01677,"longitude":-114.23938,"timestamp":"2026-03-30T00:12:34Z","groundspeed":1,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"},{"heading":0,"altitude":112,"latitude":33.01671,"longitude":-114.23936,"timestamp":"2026-03-30T00:13:29Z","groundspeed":0,"update_type":"A","fa_flight_id":"N801XR-1763945837-adhoc-1279p","altitude_change":"-"}]}},"exampleRequest":{"query":"United Airlines","filter":"airborne","unique_flights":true},"tags":["flightaware","flights","google-flights","seats-aero","travel","data","web"],"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":"mpp","network":"tempo","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.1","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_m0xIbfs2boOTQICeY5Ojf","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_v9AFPe2ZWlS2GLYJep82p","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"StableTravel","brandSlug":"stabletravel","brandBaseUrl":"https://stabletravel.dev","brandDocsUrl":"https://stabletravel.dev","whatItDoes":"Search for flights with real-time position data using a query string, with optional filtering by flight state","exampleAgentPrompt":"Search FlightAware for all airborne Delta flights right now — use the query 'DAL' and filter for airborne only, returning only unique flights.","exampleUseCases":null,"resultDescription":"Returns an array of flights with rich detail including flight identifier (IATA/ICAO), operator, origin and destination airports (with city, codes, timezone), route, flight type (Airline/General_Aviation/Cargo), status, actual departure and arrival times, codeshares, and a pagination link for next results.","failureModes":["Empty results if the query string matches no active flights","Invalid filter value returns validation error","Missing required 'query' parameter returns 400 error","Upstream FlightAware API unavailability causes 502 or timeout","Rate limiting or payment failure returns 402 if USDC payment not processed"],"whenToPreferThis":"Use this endpoint when you need to search for flights by a flexible query string (callsign, tail number, operator code, etc.) and also need position/location data alongside flight details. Prefer this over the airport-specific flights or scheduled arrivals endpoints when you don't have a specific airport context but want to match flights broadly and need their real-time state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:47:49.070Z","isFirstParty":false,"canonicalSlug":"stabletravel-positions-a78525f3"}