# Vextorium Airport Search API

> Vextorium Airport Search API is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-13).

Find airports by IATA/ICAO code, name, city, or nearest to coordinates, returning full airport details from OurAirports open data.

## Facts

- Endpoint: POST https://api.vextorium.com/aeropuerto-buscar-pago?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-airport-search-api-55d536d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_S2dbxAJnSP5AqA8aLEzPW

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 vextorium-airport-search-api-55d536d1 -d '<json body>'
```

Example prompt: Can you look up the airport with IATA code LAX and give me its full details including ICAO code, coordinates, elevation, and whether it has scheduled service?

## When to prefer this

Use this endpoint when you need structured airport data (codes, coordinates, elevation, scheduled service) from OurAirports open data. It supports three lookup modes: by IATA/ICAO code, by name/city text search, or by geographic proximity to coordinates. Prefer this over manual lookups or flight APIs when you only need airport metadata rather than flight schedules or pricing.

## Known failure modes

- No airports found for the given query — returns empty aeropuertos array
- Invalid or unrecognized IATA/ICAO code — returns empty results
- Coordinates out of range or missing lat/lon when using coordinate-based search — may return error or empty results
- Rate limiting or payment failure — HTTP 402 or 429 response
- Malformed request body missing required fields — HTTP 400 response

## How this service works

Find airports by IATA/ICAO code, name or city, or the nearest to coordinates: name, codes, city, country, coordinates, elevation and scheduled service. OurAirports open data.

## Output

Returns a JSON object with the query string, data source attribution (OurAirports), and an array of matching airports. Each airport includes: name, IATA code, ICAO code, city, country (ISO), region, airport type (e.g. large/medium/small), latitude, longitude, elevation in meters, and a boolean indicating whether scheduled commercial service operates there.

## 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": {
     "required": [],
     "properties": {
      "lat": {
       "type": "number"
      },
      "lon": {
       "type": "number"
      },
      "limite": {
       "type": "integer"
      },
      "consulta": {
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "consulta": {
       "type": [
        "string",
        "null"
       ]
      },
      "aeropuertos": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "lat": {
          "type": [
           "number",
           "null"
          ]
         },
         "lon": {
          "type": [
           "number",
           "null"
          ]
         },
         "iata": {
          "type": [
           "string",
           "null"
          ]
         },
         "icao": {
          "type": [
           "string",
           "null"
          ]
         },
         "pais": {
          "type": [
           "string",
           "null"
          ]
         },
         "tipo": {
          "type": [
           "string",
           "null"
          ]
         },
         "ciudad": {
          "type": [
           "string",
           "null"
          ]
         },
         "nombre": {
          "type": [
           "string",
           "null"
          ]
         },
         "region": {
          "type": [
           "string",
           "null"
          ]
         },
         "altitud_m": {
          "type": [
           "number",
           "null"
          ]
         },
         "vuelos_regulares": {
          "type": [
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fuente": "OurAirports (dominio público)",
  "consulta": "MAD",
  "aeropuertos": [
   {
    "lat": 40.493407,
    "lon": -3.572249,
    "iata": "MAD",
    "icao": "LEMD",
    "pais": "ES",
    "tipo": "grande",
    "ciudad": "Madrid",
    "nombre": "Adolfo Suárez Madrid–Barajas Airport",
    "region": "ES-MD",
    "altitud_m": 609,
    "vuelos_regulares": true
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-airport-search-api-55d536d1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)