# fittings Nearby Airports

> fittings Nearby Airports is a paid API for AI agents from fittings.sh, paid per call via x402, $0.00398/call, status unknown (last checked 2026-09-14).

Returns commercial airports within a configurable radius of a geographic coordinate, sorted by distance, with IATA/ICAO codes, city name, and bearing.

## Facts

- Endpoint: GET https://fittings.sh/v1/airport/nearby
- Price: $0.00398/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fittings-nearby-airports-8cb4abf7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jl8dUv8In2tXe__8YvTLe

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 fittings-nearby-airports-8cb4abf7
```

Example prompt: Find all commercial airports within 150km of coordinates 48.8566, 2.3522 — give me their IATA and ICAO codes, city names, distances, and bearings, up to 20 results.

## When to prefer this

Use this endpoint when you need structured, code-ready airport data (IATA/ICAO codes, bearing, distance) for a coordinate rather than a city name or address. It is preferable over a general geocoding or text-search approach when you need aviation identifiers and precise geospatial sorting. Best for travel apps, logistics routing, flight planning tools, or any workflow that needs to enumerate nearby commercial airports programmatically.

## Known failure modes

- Missing required lat or lon parameters returns an error
- Latitude outside -90 to 90 or longitude outside -180 to 180 returns a validation error
- Radius outside 1-500km range returns a validation error
- Limit outside 1-50 range returns a validation error
- No airports found within the specified radius returns an empty result set
- Payment not provided or insufficient USDC triggers x402 payment required response

## How this service works

Commercial airports within a radius of a coordinate, sorted by distance, with IATA and ICAO codes, city and bearing.

## Output

A list of commercial airports sorted by ascending distance from the given coordinate, each containing the airport name, IATA code, ICAO code, city, distance in kilometers, and initial bearing in degrees.

## Request schema (JSON Schema)

```json
{
 "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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Latitude, -90 to 90"
      },
      "lon": {
       "type": "number",
       "description": "Longitude, -180 to 180"
      },
      "limit": {
       "type": "number",
       "description": "1-50, default 10"
      },
      "radiusKm": {
       "type": "number",
       "description": "Search radius in km, 1-500, default 100"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fittings-nearby-airports-8cb4abf7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fittings.sh](https://www.zero.xyz/host/fittings.sh/llms.txt)