# AviationAPIs Flight Status

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

Returns real-time flight status including departure/arrival times, gate info, aircraft type, and en-route status for a given flight number or tail number.

## Facts

- Endpoint: POST https://aviationapis.com/flight-status?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aviationapis-flight-status-9d26d473
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1CCQCxLneH3hJo6OgoSdU

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-flight-status-9d26d473 -d '<json body>'
```

Example prompt: Can you check the current status of flight BA117, including whether it's departed, what gate it left from, and when it's expected to arrive at JFK?

## When to prefer this

Use this endpoint when you need live or near-real-time flight status data including gate information, actual vs. scheduled times, and aircraft details — especially when you have a specific flight number or tail number to look up. Prefer this over general aviation data providers when you need pay-per-call pricing with no subscription commitment and USDC settlement via x402.

## Known failure modes

- Flight number not found or invalid — empty or error response
- Tail number not recognized — no matching aircraft record
- Flight has not yet been assigned a status — null fields returned
- Both 'tail' and 'flight' omitted — likely returns an error or empty result
- Data temporarily unavailable from upstream sources — stale or missing fetched_at

## How this service works

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

## Output

A JSON object containing the queried flight's origin and destination ICAO codes, current status (e.g. en-route, landed), callsign, registration, aircraft type, scheduled and actual departure/arrival times, and gate assignments for origin and destination.

## 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": "BA117"
  },
  "origin": "EGLL",
  "status": "en-route",
  "callsign": "BAW117",
  "fetched_at": "2026-06-02T18:58:11.000Z",
  "destination": "KJFK",
  "gate_origin": "A12",
  "observed_at": "2026-06-02T18:54:00.000Z",
  "registration": "G-XWBA",
  "aircraft_type": "A35K",
  "flight_number": "BA117",
  "actual_arrival": null,
  "actual_departure": "2026-06-02T13:48:00Z",
  "gate_destination": "7",
  "scheduled_arrival": "2026-06-02T21:55:00Z",
  "scheduled_departure": "2026-06-02T13:30:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aviationapis-flight-status-9d26d473/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)