# aviationapis.com Aircraft Position

> aviationapis.com Aircraft Position is a paid API for AI agents from aviationapis.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-13).

Returns real-time position data for a specific aircraft, including coordinates, altitude, heading, and route information.

## Facts

- Endpoint: POST https://aviationapis.com/aircraft-position?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aviationapis-com-aircraft-position-3d76fe33
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7Umm-9me95tbi7llLhefR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aviationapis-com-aircraft-position-3d76fe33 -d '<json body>'
```

Example prompt: Where is United flight UA123 right now — what are its coordinates, altitude, and heading, and where is it flying from and to?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Pay-per-call aviation data APIs for AI agents, settled in USDC via the x402 protocol.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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'"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aviationapis-com-aircraft-position-3d76fe33/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aviationapis.com](https://www.zero.xyz/host/aviationapis.com/llms.txt)