IATA city / metro code -> airports API

Resolve a 3-letter IATA code (cached daily from the OurAirports dataset): a metropolitan code (NYC, LON, TYO) expands to all serving airports, while an airport code (JFK) resolves to its city and that city's other airports. The MORE: a curated metro-code -> member-airport table joined against the ~75k-row OurAirports corpus. Answers 'what airports serve NYC', 'which city is JFK in', 'expand the LON metro code', 'airports for this city code'.

Price$0.01per request

MethodPOST

Route/v1/ref/iata-city

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

refiataairportcity-codemetro-codeaviationairportsourairports

API URLhttps://x402.hexl.dev/v1/ref/iata-city

Integration docs

Example request

{
  "code": "NYC"
}

Example response

{
  "code": "NYC",
  "isMetroCode": true,
  "city": "New York",
  "country": "US",
  "airportCount": 3,
  "airports": [
    {
      "iata": "JFK",
      "name": "John F Kennedy International Airport",
      "municipality": "New York",
      "country": "US",
      "type": "large_airport",
      "latitude": 40.639447,
      "longitude": -73.779317
    },
    {
      "iata": "LGA",
      "name": "LaGuardia Airport",
      "municipality": "New York",
      "country": "US",
      "type": "large_airport",
      "latitude": 40.777245,
      "longitude": -73.872608
    },
    {
      "iata": "EWR",
      "name": "Newark Liberty International Airport",
      "municipality": "Newark",
      "country": "US",
      "type": "large_airport",
      "latitude": 40.692501,
      "longitude": -74.168701
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "examples": [
        "NYC"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}