# Nearest Airports by Road Drive Time

> Nearest Airports by Road Drive Time is a paid API for AI agents from api.flipvo.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-02).

Returns up to 5 airports with scheduled service nearest to a named location, ranked by real road driving time with IATA/ICAO codes

## Facts

- Endpoint: POST https://api.flipvo.com/v1/airport/nearest?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nearest-airports-by-road-drive-time-1d143c23
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EytiOyMvxlsiJn-88o_fz

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 nearest-airports-by-road-drive-time-1d143c23 -d '<json body>'
```

Example prompt: What are the 3 nearest airports to Lakeland, FL with scheduled service, ranked by actual driving time — include their IATA and ICAO codes?

## When to prefer this

Choose this endpoint when you need real road driving time to airports rather than straight-line (as-the-crow-flies) distance, which can be misleading in areas with geographic barriers. Ideal for travel planning, itinerary building, corporate travel tools, or any agent that needs to suggest realistic airport options to a traveler based on actual drive time. Prefer the 'large' airport_size filter when the user specifically needs major hub airports. Worldwide coverage via OpenStreetMap and OurAirports makes it suitable for international use cases, not just domestic US queries.

## Known failure modes

- 422 returned when no airports with scheduled service exist within 300 km of the location
- Airports unreachable by road (e.g. island airports) are excluded from results
- Ambiguous location names may resolve to unexpected places — use the 'near' disambiguation hint to clarify
- If k exceeds available airports in range, fewer results are returned without error
- Invalid or unrecognized location strings may produce no results or incorrect geocoding

## How this service works

Up to 5 airports with scheduled service nearest a named place, ranked by real road drive time (never a straight-line guess), with IATA and ICAO codes. airport_size 'large' keeps large airports only. Within 300 km; none in range is a 422; airports with no road route are left out. OpenStreetMap routing, OurAirports data, worldwide.

## Output

A ranked list of up to 5 airports (limited by the k parameter) sorted by real road driving time from the specified location. Each entry includes airport name, IATA code, ICAO code, airport size classification, driving distance, and driving time. Returns a 422 error if no airports with road routes exist within 300 km of the location.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "k": {
   "type": "integer",
   "title": "K",
   "default": 3,
   "maximum": 5,
   "minimum": 1,
   "description": "How many airports"
  },
  "near": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 200
    },
    {
     "type": "null"
    }
   ],
   "title": "Near",
   "default": null,
   "description": "Disambiguation hint, e.g. 'Florida'"
  },
  "location": {
   "type": "string",
   "title": "Location",
   "pattern": "\\S",
   "examples": [
    "Lakeland, FL"
   ],
   "maxLength": 200,
   "minLength": 1
  },
  "airport_size": {
   "enum": [
    "scheduled",
    "large"
   ],
   "type": "string",
   "title": "Airport Size",
   "default": "scheduled",
   "description": "scheduled: any airport with scheduled passenger service. large: OurAirports type large_airport with scheduled service."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nearest-airports-by-road-drive-time-1d143c23/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.flipvo.com](https://www.zero.xyz/host/api.flipvo.com/llms.txt)