# x402.forgemesh.io Flight Code Lookup

> x402.forgemesh.io Flight Code Lookup 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-14).

Resolves IATA (3-letter) or ICAO (4-letter) airport codes to full airport details including name, city, country, coordinates, elevation, and timezone.

## Facts

- Endpoint: POST https://x402.forgemesh.io/flight-code-lookup
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-forgemesh-io-flight-code-lookup-716632f9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_djfZZHScsKH7fjkEAORWS

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 x402-forgemesh-io-flight-code-lookup-716632f9 -d '<json body>'
```

Example prompt: What airport does the code LHR refer to — can you give me the full name, city, country, coordinates, and timezone?

## When to prefer this

Choose this endpoint when you need instant, structured airport metadata from a single code lookup without maintaining your own reference database. Ideal for booking engines, itinerary builders, dispatch systems, and travel apps that need to resolve IATA or ICAO codes on demand at low cost ($0.003/call). Prefer this over maintaining a local database when freshness and coverage (29,000+ airports) matter.

## Known failure modes

- Unknown or invalid code returns an error or empty result
- Codes with regional ambiguity (e.g. shared codes) may return unexpected airports
- Payment failure (insufficient USDC balance) blocks the request
- Malformed code (wrong length or non-alphabetic characters) returns validation error

## How this service works

Instant lookup for any 3-letter or 4-letter flight code, returning the matching airport's full name, city, country, coordinates, elevation, and local timezone from a database of 29,000+ airports. Built for booking engines, itinerary builders, and dispatch systems that need to resolve a code without maintaining their own reference table.

## Output

Returns the airport's full official name, the city it serves, the country, geographic coordinates (latitude/longitude), elevation in feet or meters, and the IANA local timezone string — all in a single response for the queried 3-letter IATA or 4-letter ICAO code.

## 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/x402-forgemesh-io-flight-code-lookup-716632f9/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)
