# Vextorium Airport Distance Calculator

> Vextorium Airport Distance Calculator 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-15).

Calculates the straight-line distance, approximate flight time, bearing, and CO2 emissions between two airports identified by IATA or ICAO code.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/airport-distance?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-airport-distance-calculator-cb4016c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_U7uoHPuHpbEakwmsFqyfl

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-distance-calculator-cb4016c4 -d '<json body>'
```

Example prompt: What's the great-circle distance and estimated flight time between MAD (Madrid Barajas) and JFK (New York Kennedy), and how much CO2 per passenger roughly?

## When to prefer this

Use this endpoint when you need fast, structured, pay-per-call airport distance data including CO2 estimates and bearing without relying on a full flight search API. Ideal for agents that need geospatial aviation data without flight availability or pricing — e.g. carbon calculators, route planners, logistics tools, or travel apps needing distance enrichment. Prefer over generic geocoding APIs when the inputs are airport codes and aviation-specific output (nautical miles, bearing, CO2) is needed.

## Known failure modes

- Unknown or invalid IATA/ICAO code returns an error or null airport metadata
- Missing required origin or destination field returns a 400 validation error
- Ambiguous airport identifier may resolve to the wrong airport
- CO2 and flight time values are estimates and may not reflect actual airline routing

## How this service works

Great-circle distance between two airports by IATA or ICAO code in km, miles and nautical miles, bearing, approximate flight time and estimated economy-class CO2 per passenger.

## Output

Returns a JSON object with full metadata for both origin and destination airports (IATA, ICAO, name, city, country, region, lat/lon, altitude, type, regular flights flag), plus computed values: distance in km, miles, and nautical miles; approximate flight time in hours; initial bearing in degrees; and estimated CO2 per passenger in kg. Includes a note that the straight-line distance is typically 3–8% shorter than the actual route.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "origin": {
   "type": "string"
  },
  "destination": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Straight-line distance; the real route is usually 3-8% longer. CO2 is indicative.",
  "origin": {
   "lat": 40.493407,
   "lon": -3.572249,
   "city": "Madrid",
   "iata": "MAD",
   "icao": "LEMD",
   "name": "Adolfo Suárez Madrid–Barajas Airport",
   "type": "large",
   "region": "ES-MD",
   "country": "ES",
   "altitude_m": 609,
   "regular_flights": true
  },
  "destination": {
   "lat": 40.639447,
   "lon": -73.779317,
   "city": "New York",
   "iata": "JFK",
   "icao": "KJFK",
   "name": "John F. Kennedy International Airport",
   "type": "large",
   "region": "US-NY",
   "country": "US",
   "altitude_m": 4,
   "regular_flights": true
  },
  "distance_km": 5775.071,
  "distance_miles": 3588.463,
  "flight_time_approx_h": 7.72,
  "distance_nautical_miles": 3118.289,
  "initial_bearing_degrees": 294.7,
  "co2_per_passenger_kg_approx": 686
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-airport-distance-calculator-cb4016c4/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)