# Airport Nearest Search by Coordinates

> Airport Nearest Search by Coordinates is a paid API for AI agents from airport.openverbs.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-15).

Finds airports nearest to a given latitude/longitude, ordered by great-circle distance, with optional filters for radius, result count, and airport type.

## Facts

- Endpoint: POST https://airport.openverbs.com/v1/nearest
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/airport-nearest-search-by-coordinates-893edd8c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B7xrxVZe0dmviWy50qW-f

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 airport-nearest-search-by-coordinates-893edd8c -d '<json body>'
```

Example prompt: Find me the 5 nearest large airports within 300km of latitude 48.8566, longitude 2.3522 — ordered by distance.

## When to prefer this

Use this endpoint when you have a geographic coordinate (lat/lon) and need to discover nearby airports ranked by proximity. Prefer this over fuzzy-name search when you know the location but not the airport name, or when building routing, logistics, or travel applications that need the geographically closest options. Choose the radius and type filters to narrow results for specialized use cases like finding only large commercial airports or heliports.

## Known failure modes

- Missing required lat or lon fields returns a validation error
- Latitude outside -90 to 90 or longitude outside -180 to 180 returns a schema error
- Invalid airport type enum value returns a validation error
- limit out of range (< 1 or > 50) returns a validation error
- No airports found within the specified radius returns an empty results list
- Network timeout or service unavailability returns a 5xx error

## How this service works

Find the airports nearest to a latitude/longitude, ordered by great-circle distance. Optionally cap the search radius (km), result count and airport type. Returns each airport with its distance in km.

## Output

Returns a list of airports ordered by great-circle distance from the provided coordinates. Each airport entry includes its name, IATA/ICAO code, airport type, and distance in km from the query point. Results are capped by the requested limit (default 5) and search radius (default 500km).

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "lat": {
       "type": "number",
       "minimum": -90,
       "maximum": 90,
       "description": "Latitude in decimal degrees."
      },
      "lon": {
       "type": "number",
       "minimum": -180,
       "maximum": 180,
       "description": "Longitude in decimal degrees."
      },
      "radiusKm": {
       "type": "number",
       "description": "Search radius in km (default 500, max 20000)."
      },
      "limit": {
       "type": "integer",
       "minimum": 1,
       "maximum": 50,
       "description": "Maximum airports to return. Default 5."
      },
      "type": {
       "type": "string",
       "enum": [
        "large",
        "medium",
        "small",
        "seaplane_base",
        "heliport",
        "balloonport",
        "closed"
       ],
       "description": "Optional airport-type filter."
      }
     },
     "required": [
      "lat",
      "lon"
     ],
     "additionalProperties": false
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/airport-nearest-search-by-coordinates-893edd8c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from airport.openverbs.com](https://www.zero.xyz/host/airport.openverbs.com/llms.txt)