{"uid":"cap_IKJL-LwpJhNRx-OEtLtWj","slug":"flightaware-903eacf0","name":"FlightAware Flight Track (Position History)","description":"Get the flight track (position history) for a flight","url":"https://stabletravel.dev/api/flightaware/flights/UAL237-1779611729-fa-1059p/track","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":{"include_estimated_positions":{"type":"boolean","description":"Include estimated positions"}},"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":["positions"],"properties":{"positions":{"type":"array","items":{"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}}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"include_estimated_positions":true}}},"response":{"_truncated":true,"_originalSize":136844}},"exampleRequest":{"include_estimated_positions":true},"tags":["x402"],"displayCostAmount":"0.024","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.024/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.024","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.024","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a25EbNl-J858dISi-uHDA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.024","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the position history (flight track) for a specific flight identified by its FlightAware flight ID, including coordinates, altitude, heading, and groundspeed at each recorded position.","exampleAgentPrompt":"Can you pull up the full position history for FlightAware flight UAL237-1779611729-fa-1059p, including any estimated positions?","exampleUseCases":null,"resultDescription":"An array of position objects each containing latitude, longitude, altitude, heading, groundspeed, timestamp, altitude_change direction, update_type, and the fa_flight_id — forming a breadcrumb trail of the flight's path.","failureModes":["Invalid or expired fa_flight_id returns 404 or empty positions array","Flight ID not found in FlightAware system returns error","Payment failure (402) if x402 micropayment not completed","Network timeout if FlightAware upstream is slow","Flight has no recorded positions yet (very early or untracked flight) returns empty array"],"whenToPreferThis":"Use this endpoint when you need the detailed position history (breadcrumb trail) of a specific flight already identified by its FlightAware flight ID. Prefer this over general flight search endpoints when you already have the fa_flight_id and need granular lat/lon/altitude/speed data points along the route rather than just departure/arrival summary info.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:07:22.750Z","isFirstParty":false}