# ForgeMesh IATA/ICAO Airport Code Resolver

> ForgeMesh IATA/ICAO Airport Code Resolver is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Resolves an IATA (3-letter) or ICAO (4-letter) airport code to full airport details including name, city, country, coordinates, elevation, and timezone from a database of 29,000+ airports.

## Facts

- Endpoint: POST https://x402.forgemesh.io/iata-icao-codes
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-iata-icao-airport-code-resolver-ab41dc50
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xFcq0BPT2BxtejOqja8By

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 forgemesh-iata-icao-airport-code-resolver-ab41dc50 -d '<json body>'
```

Example prompt: What airport is IAH — give me its full name, city, country, coordinates, elevation, and timezone.

## When to prefer this

Prefer this endpoint when you need fast, offline-style resolution of IATA or ICAO codes to rich airport metadata (name, city, country, coordinates, elevation, timezone) without hitting external aviation databases. Ideal for travel agents, logistics pipelines, and flight-data enrichment workflows that need reliable sub-millisecond lookups across 29,000+ global airports. Choose this over general geocoding APIs when your input is specifically an airport code rather than an address or city name.

## Known failure modes

- Invalid or unknown airport code returns an error or empty result
- Malformed code (wrong length, non-standard format) may fail validation
- Decommissioned or very obscure airstrips may not be in the database
- Network or payment authorization failure returns a 402 or connectivity error

## How this service works

Airport code API: resolve any IATA (IAH) or ICAO (KIAH) code to airport name, city, country, coordinates, elevation, and timezone — 29,000+ airports, served locally in milliseconds. For travel, logistics, and aviation agents.

## Output

Returns structured airport data for the queried IATA or ICAO code, including the official airport name, city, country, geographic coordinates (latitude/longitude), elevation, and timezone. Covers 29,000+ airports worldwide, served from local data in milliseconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "code": {
   "type": "string",
   "description": "IATA (3) or ICAO (4) code"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "city": "Houston",
  "iata": "IAH",
  "icao": "KIAH",
  "name": "George Bush Intercontinental Houston Airport",
  "country": "US",
  "timezone": "America/Chicago"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-iata-icao-airport-code-resolver-ab41dc50/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)