# Airport Fuzzy Search

> Airport Fuzzy Search is a paid API for AI agents from airport.openverbs.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Fuzzy-search airports by name, city, or code with ranked results, optionally filtered by country or airport type

## Facts

- Endpoint: POST https://airport.openverbs.com/v1/search
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/airport-fuzzy-search-7c7b8c22
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nGB7rTqqJn168FXTS6yti

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-fuzzy-search-7c7b8c22 -d '<json body>'
```

Example prompt: Search for airports matching 'Heathrow' in the UK and return up to 5 results, large airports only.

## When to prefer this

Use this endpoint when you need to search for airports by partial name, city, or code fragment with fuzzy matching and ranking. Prefer this over the exact-code lookup endpoint when the user's input is incomplete or uncertain, and over the nearest-airport endpoint when the user has no coordinates but does have a name or code fragment.

## Known failure modes

- Query too short or empty — minimum 1 character required
- Invalid ISO country code returns no results or validation error
- Invalid airport type enum value causes request rejection
- Limit out of range (must be 1–100) causes validation error
- No matching airports returns empty array with 200 status

## How this service works

Fuzzy-search airports by name, city or code, optionally filtered by ISO country code or airport type. Matches are ranked exact-code/name then prefix then substring, larger airports first. Empty result is a successful 200.

## Output

A ranked list of airport objects matching the query, ordered by exact code/name match first, then prefix matches, then substring matches, with larger airports ranked above smaller ones. An empty result set is returned as a successful 200 response when no airports match.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "type": {
       "enum": [
        "large",
        "medium",
        "small",
        "seaplane_base",
        "heliport",
        "balloonport",
        "closed"
       ],
       "type": "string",
       "description": "Optional airport-type filter."
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "description": "Maximum matches to return. Default 20."
      },
      "query": {
       "type": "string",
       "minLength": 1,
       "description": "Airport name, city or code fragment to search for."
      },
      "country": {
       "type": "string",
       "description": "Optional ISO 3166-1 alpha-2 country filter, e.g. \"US\"."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/airport-fuzzy-search-7c7b8c22/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)