# aviationapis.com Flight Category

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

Returns the flight category (VFR, IFR, MVFR, LIFR) for an airport based on current ceiling and visibility conditions, given an ICAO airport code.

## Facts

- Endpoint: POST https://aviationapis.com/flight-category
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aviationapis-com-flight-category-10893e87
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g_dsJLE3mrZ9-P9naEY32

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-flight-category-10893e87 -d '<json body>'
```

Example prompt: What's the current flight category at Chicago O'Hare — is it VFR, MVFR, IFR, or LIFR? The ICAO code is KORD.

## When to prefer this

Use this endpoint when you need a quick, categorized flight condition status (VFR/MVFR/IFR/LIFR) for a specific airport identified by its ICAO code. Prefer this over raw METAR endpoints when you need a pre-computed flight category label rather than raw weather strings. Ideal for AI agents automating pre-flight checks, go/no-go decisions, or flight planning workflows.

## Known failure modes

- Invalid or malformed ICAO code (not exactly 4 letters) returns a validation error
- Airport not found or no weather data available for the given ICAO code
- Stale or unavailable METAR data results in no flight category returned
- Payment failure via x402 protocol results in 402 response and no data

## 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 ICAO code, current flight category (e.g. VFR, MVFR, IFR, LIFR), ceiling in feet, visibility in statute miles, the time the observation was recorded, and the time the data was fetched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "icao": {
   "type": "string",
   "pattern": "^[A-Za-z]{4}$",
   "description": "4-letter ICAO airport code (e.g. 'KSFO', 'EGLL', 'RJTT')"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "icao": "KORD",
  "ceiling_ft": 1800,
  "fetched_at": "2026-06-02T18:58:11.000Z",
  "observed_at": "2026-06-02T18:51:00Z",
  "visibility_sm": 4,
  "flight_category": "MVFR"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aviationapis-com-flight-category-10893e87/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)