Airlines 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://airhex.com/api/v1/airlines?iata=DL"

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

Query airline data. Returns matching airlines as a JSON array. At least one filter parameter is required on Starter plans — Growth and Enterprise plans may omit filters to retrieve the full dataset.

Parameters

Response Fields

Airline object

Response Example

[
  {
    "airhex_id": "377",
    "updated": "2023-05-15 09:42:10",
    "iata": "DL",
    "icao": "DAL",
    "parent_icao": null,  // Starter+
    "marketing_name": "Delta",
    "full_name": "Delta Air Lines Inc.",  // Starter+
    "active": true,  // Starter+
    "type": "SCHEDULED",  // Starter+
    "type_code": "1",  // Starter+
    "country_code_alpha_2": "US",  // Starter+
    "country_code_alpha_3": "USA",  // Starter+
    "country_name": "United States",  // Starter+
    "founded": "1924",  // Starter+
    "alliance": "SkyTeam",  // Growth+
    "lowcost": false,  // Growth+
    "ffp_name": "SkyMiles",  // Growth+
    "colorscheme": [  // Growth+
      {
        "color": [
          156,
          28,
          52
        ],
        "percent": 50,
        "hex": "#9C1C34",
        "dark": 1
      },
      {
        "color": [
          228,
          28,
          52
        ],
        "percent": 50,
        "hex": "#E41C34",
        "dark": 1
      }
    ],
    "website": "https://www.delta.com",  // Growth+
    "web_checkin_url": "https://www.delta.com/PCCOciWeb/findBy.action",  // Growth+
    "baggage_url": "https://www.delta.com/us/en/baggage/overview",  // Growth+
    "city_code": "ATL"  // Enterprise
  }
]

Code	Description
400	Bad request — invalid or conflicting query parameters (e.g. name 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, alliance filter on Starter, inactive API key)
404	Not found — no matching airline for the given code
429	Too many requests — per-second rate limit exceeded. Back off and retry.

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.