Airports API Reference

Authentication

All API requests require a valid API key. Pass it as a Bearer token in the Authorization header, or via the X-API-Key header. Keys are delivered immediately after subscribing.

Don't have an API key yet? Get started — you'll have a key in minutes.

# Bearer token (recommended)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.airhex.com/v1/airports?iata=JFK"

# Alternative: X-API-Key header
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.airhex.com/v1/airports?iata=JFK"

Query airport data. Returns a JSON object with a `data` array of matching airports (each enriched with nested city and country objects), a `total` count, and a `truncated` flag. At least one filter parameter is required on Starter plans. Sandbox and Starter plans return a limited number of results per filter query (3 and 10 respectively).

Parameters

Response Fields

Airport object

Nested city object

Nested country object

Response Example

{
  "data": [
    {
      "iata": "LHR",
      "icao": "EGLL",
      "name": "London Heathrow Airport",
      "city_code": "LON",
      "country_code": "GB",
      "active": true,  // Starter+
      "sub_type": null,  // Starter+
      "latitude": "51.469603",  // Growth+
      "longitude": "-0.453566",  // Growth+
      "timezone": "Europe/London",  // Growth+
      "utc": "1",  // Growth+
      "avg_weekly_flights": "1587",  // Growth+
      "major_airport": true,  // Growth+
      "website": "https://www.heathrow.com",  // Growth+
      "phone_local": "0844 335 1801",  // Growth+
      "phone_intl": "+44 844 335 1801",  // Growth+
      "address": "Longford TW6, UK",  // Growth+
      "city": {
        "code": "LON",
        "name": "London",
        "country_code": "GB",
        "state_short": null,  // Starter+
        "state_full": null,  // Starter+
        "latitude": "51.5073509",  // Growth+
        "longitude": "-0.1277583",  // Growth+
        "timezone": "Europe/London",  // Growth+
        "gmt": "1",  // Growth+
        "population": "9648110",  // Growth+
        "popularity": "34038532",  // Growth+
        "city_photo": "https://content.airhex.com/content/city_photos/4241.jpg"  // Growth+
      },
      "country": {
        "code2": "GB",
        "code3": "GBR",  // Starter+
        "name": "United Kingdom",
        "iso": "826",  // Growth+
        "capital_code": "LON",  // Growth+
        "currency_code": "GBP",  // Growth+
        "region": "Europe",  // Growth+
        "continent_code": "EU",  // Growth+
        "population": "62348447",  // Growth+
        "phone_code": "+44"  // Growth+
      }
    }
  ],
  "total": 1,
  "truncated": false
}

Code	Description
400	Bad request — invalid query parameters (e.g. name or city search under 2 characters)
401	Unauthorized — missing or invalid API key. Check your Authorization header.
403	Forbidden — your plan does not permit this operation (e.g. bulk listing on Starter, major_only filter on Starter, inactive API key)
404	Not found — no matching airport for the given code
429	Too many requests — per-second rate limit exceeded. Back off and retry.
503	Service temporarily unavailable. Retry after a few seconds.

Rate Limits

All plans include unlimited monthly requests with fair-use rate limiting enforced per second. Standard rate headers (RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset) are included in every response. Responses also include Cache-Control headers — caching responses locally is recommended to stay well within limits.