# Airports Reference – Airport Lookup by Code or Name

> Airports Reference – Airport Lookup by Code or Name is a paid API for AI agents from airports-reference.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Look up an airport by IATA code, ICAO code, or name (with fuzzy matching) and return its location, elevation, type, and longest runway.

## Facts

- Endpoint: GET https://airports-reference.x402tookit.com/airport-lookup?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/airports-reference-airport-lookup-by-code-or-name-dc18b662
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8wrcPSCIKab2w8xK7ce99

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 airports-reference-airport-lookup-by-code-or-name-dc18b662
```

Example prompt: Can you look up the airport with IATA code SFO and tell me its exact coordinates, elevation, type, and how long its longest runway is?

## When to prefer this

Choose this endpoint when you need to resolve an airport identifier (IATA, ICAO, or a human-readable name) into structured reference data including location, elevation, and runway info. It supports fuzzy name matching, making it suitable for user-supplied freeform input. Prefer sibling endpoints for nearest-airport searches, country listings, code conversions, or great-circle distances.

## Known failure modes

- No airport found for the given code or name — returns empty matches array
- Ambiguous name query returns multiple low-confidence matches requiring disambiguation
- Malformed or non-existent IATA/ICAO code returns no results
- Optional country filter may not narrow results if country code is unrecognized
- Network or payment authorization failure returns HTTP error

## How this service works

Find an airport by IATA code, ICAO code or name with fuzzy matching: location, elevation, type, longest runway.

## Output

A list of matching airport records scored by relevance, each containing IATA code, ICAO code, full name, latitude, longitude, elevation in meters and feet, airport type, longest runway in feet, municipality, region, country, scheduled service flag, Wikipedia URL, and the field that was matched on. Also includes a summary and any relevant disclaimers.

## 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": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "IATA (JFK), ICAO (KJFK) or name (Heathrow, Kennedy Intl)"
      },
      "country": {
       "type": "string",
       "description": "Optional ISO country code or name to narrow a name search"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "input": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "matches": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "lat": {
          "type": [
           "null",
           "number"
          ]
         },
         "lon": {
          "type": [
           "null",
           "number"
          ]
         },
         "iata": {
          "type": [
           "null",
           "string"
          ]
         },
         "icao": {
          "type": [
           "null",
           "string"
          ]
         },
         "name": {
          "type": [
           "null",
           "string"
          ]
         },
         "type": {
          "type": [
           "null",
           "string"
          ]
         },
         "ident": {
          "type": [
           "null",
           "string"
          ]
         },
         "score": {
          "type": [
           "null",
           "number"
          ]
         },
         "region": {
          "type": [
           "null",
           "string"
          ]
         },
         "country": {
          "type": [
           "null",
           "string"
          ]
         },
         "matchedOn": {
          "type": [
           "null",
           "string"
     
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/airports-reference-airport-lookup-by-code-or-name-dc18b662/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from airports-reference.x402tookit.com](https://www.zero.xyz/host/airports-reference.x402tookit.com/llms.txt)