{"uid":"cap_7Umm-9me95tbi7llLhefR","slug":"aviationapis-com-aircraft-position-3d76fe33","name":"aviationapis.com Aircraft Position","description":"Pay-per-call aviation data APIs for AI agents, settled in USDC via the x402 protocol.","url":"https://aviationapis.com/aircraft-position?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tail":{"type":"string","description":"Aircraft registration (tail number), e.g. 'N12345', 'G-EUPT'"},"flight":{"type":"string","description":"Flight number / callsign, e.g. 'UAL123', 'BA117'"}}},"responseSchema":{"type":"json","example":{"query":{"flight":"UAL123"},"origin":"KSFO","callsign":"UAL123","latitude":39.12,"longitude":-101.45,"track_deg":84,"fetched_at":"2026-06-02T18:58:11.000Z","altitude_ft":37000,"destination":"KORD","observed_at":"2026-06-02T18:54:00.000Z","registration":"N12345","aircraft_type":"B739","flight_number":"UA123"}},"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_XstDLynyA3fUmZzd-MhjB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time position data for a specific aircraft, including coordinates, altitude, heading, and route information.","exampleAgentPrompt":"Where is United flight UA123 right now — what are its coordinates, altitude, and heading, and where is it flying from and to?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the aircraft's current latitude, longitude, altitude in feet, track heading in degrees, origin and destination airport codes, callsign, registration, aircraft type, flight number, and timestamps for when the position was observed and fetched.","failureModes":["Aircraft not found or not currently tracked — empty or null result","Invalid tail number format returns validation error","Flight number not currently active or airborne — no position data returned","Ambiguous callsign matches multiple flights — may return first match or error","Payment failure via x402 protocol — 402 response if USDC payment not settled"],"whenToPreferThis":"Use this endpoint when you need real-time positional data for a specific aircraft identified by tail number or flight number. Ideal for flight tracking applications, logistics monitoring, or when an agent needs to answer 'where is this flight right now?' with precise coordinates and altitude. Prefer this over scheduled data endpoints when live position is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-22T10:22:17.661Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:35:34.713Z","isFirstParty":false,"canonicalSlug":"aviationapis-com-aircraft-position-3d76fe33"}