Airline Logos API Reference

Airline logo API. Complete reference for the logo endpoint — retrieve airline logos in multiple formats and sizes. Download all 920 airline logos with daily updates.

API Reference

Full API Reference Airlines API Airports API Cities Data Countries Data

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/logos?codes=DL"

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

Base URL
https://api.airhex.com/v1

GET /logos

Retrieve signed logo URLs for one or more airlines. Returns a JSON object with a `data` array of airline logo entries and a `total` count. Each entry contains all logo variants available on your plan, grouped by format (png, svg), theme (light, dark), and shape (square, rectangular, tail, tail_right, circular). Width is computed from each shape's intrinsic aspect ratio (rectangular is 3.5 : 1, all others are 1 : 1). Each URL contains a cryptographic signature — load it directly in an <img> tag or download it. URLs are long-lived and CDN-cacheable.

Parameters

Name	In	Required	Description
`codes`	query	Required	Comma-separated IATA 2-letter or ICAO 3-letter airline codes (e.g. `DL` or `DL,AA,EK` — max 100). IATA codes may return multiple airlines sharing the same code. Results are deduplicated. Multi-code (more than 1) requires Growth or Enterprise.
`height`	query	Optional	Logo height in pixels (1–2 000). Width is computed automatically from each shape's aspect ratio — rectangular logos use a 3.5 : 1 ratio, all other shapes are 1 : 1. Default: 256. Sandbox and Starter are limited to 512.

Response: JSON object with a data array and total count. Each entry contains format keys (png, svg) with nested light and dark theme objects. Each shape is an object with url, width, and height fields.

Signed URLs: Each logo URL contains a ?sig= parameter. These URLs serve binary image data directly — no authentication header needed. Cache them for 7 days.

Multiple airlines: IATA codes may map to multiple airlines (e.g. parent + subsidiary). All matching airlines are returned in the data array, each with their own logo URLs.

Plan limits enforced: Available formats, shapes, dark theme, and max height depend on your plan. Sandbox: PNG only, all shapes, watermarked, max 512 px. Starter: PNG only, all shapes, light only, max 512 px. Growth & Enterprise: all formats, shapes, and themes, up to 2 000 px.

Multi-code requests: Pass comma-separated codes to fetch logos for multiple airlines in one call (e.g. ?codes=DL,AA,EK, max 100). Results are deduplicated by unique airline ID. Multi-code (more than 1) requires Growth or Enterprise plan.

Sandbox notice: Sandbox logos are watermarked. Sandbox responses include a notice field reminding that data may not be used in production or commercial products. Upgrade to a paid plan to remove watermarks.

Response Fields

Response object

Field	Type	Plan	Description
`data`	array	All	Array of airline logo objects, each with signed URLs grouped by format and theme
`total`	integer	All	Number of airlines returned
`notice`	string	All	Sandbox only — evaluation-only and watermark reminder

Airline logo object

Field	Type	Plan	Description
`iata`	string	All	IATA 2-letter airline code
`icao`	string	All	ICAO 3-letter airline code
`name`	string	All	Airline marketing name
`png`	object	All	PNG logo URLs grouped by theme → shape. Present on all plans.
`png.light`	object	All	Light-background PNG logos. Each shape key (`square`, `rectangular`, `circular`, `tail`, `tail_right`) is an object with `url`, `width`, and `height`. All plans include all five shapes.
`png.dark`	object	Growth Enterprise	Dark-background PNG logos — same structure as `png.light`.
`svg`	object	Growth Enterprise	SVG logo URLs grouped by theme → shape.
`svg.light`	object	Growth Enterprise	Light-background SVG logos — same structure as `png.light`.
`svg.dark`	object	Growth Enterprise	Dark-background SVG logos — same structure as `png.light`.

Response Example

{
  "data": [
    {
      "iata": "DL",
      "icao": "DAL",
      "name": "Delta",
      "png": {
        "light": {
          "square": {
            "url": "https://airhex.com/api/v1/logos/DAL/s/256x256.png?sig=...",
            "width": 256,
            "height": 256
          },
          "circular": {
            "url": "https://airhex.com/api/v1/logos/DAL/c/256x256.png?sig=...",
            "width": 256,
            "height": 256
          },
          "tail": {  // Growth+
            "url": "https://airhex.com/api/v1/logos/DAL/t/256x256.png?sig=...",
            "width": 256,
            "height": 256
          },
          "tail_right": {  // Growth+
            "url": "https://airhex.com/api/v1/logos/DAL/f/256x256.png?sig=...",
            "width": 256,
            "height": 256
          },
          "rectangular": {
            "url": "https://airhex.com/api/v1/logos/DAL/r/896x256.png?sig=...",
            "width": 896,
            "height": 256
          }
        },
        "dark": {  // Growth+
          "square": {
            "url": "https://airhex.com/api/v1/logos/DAL/s/256x256.png?theme=dark&sig=...",
            "width": 256,
            "height": 256
          },
          "circular": {
            "url": "https://airhex.com/api/v1/logos/DAL/c/256x256.png?theme=dark&sig=...",
            "width": 256,
            "height": 256
          },
          "tail": {  // Growth+
            "url": "https://airhex.com/api/v1/logos/DAL/t/256x256.png?theme=dark&sig=...",
            "width": 256,
            "height": 256
          },
          "tail_right": {  // Growth+
            "url": "https://airhex.com/api/v1/logos/DAL/f/256x256.png?theme=dark&sig=...",
            "width": 256,
            "height": 256
          },
          "rectangular": {
            "url": "https://airhex.com/api/v1/logos/DAL/r/896x256.png?theme=dark&sig=...",
            "width": 896,
            "height": 256
          }
        }
      },
      "svg": {  // Growth+
        "light": {
          "square": {
            "url": "https://airhex.com/api/v1/logos/DAL/s/256x256.svg?sig=...",
            "width": 256,
            "height": 256
          },
          "circular": {
            "url": "https://airhex.com/api/v1/logos/DAL/c/256x256.svg?sig=...",
            "width": 256,
            "height": 256
          },
          "tail": {  // Growth+
            "url": "https://airhex.com/api/v1/logos/DAL/t/256x256.svg?sig=...",
            "width": 256,
            "height": 256
          },
          "tail_right": {  // Growth+
            "url": "https://airhex.com/api/v1/logos/DAL/f/256x256.svg?sig=...",
            "width": 256,
            "height": 256
          },
          "rectangular": {
            "url": "https://airhex.com/api/v1/logos/DAL/r/896x256.svg?sig=...",
            "width": 896,
            "height": 256
          }
        },
        "dark": {  // Growth+
          "square": {
            "url": "https://airhex.com/api/v1/logos/DAL/s/256x256.svg?theme=dark&sig=...",
            "width": 256,
            "height": 256
          },
          "circular": {
            "url": "https://airhex.com/api/v1/logos/DAL/c/256x256.svg?theme=dark&sig=...",
            "width": 256,
            "height": 256
          },
          "tail": {  // Growth+
            "url": "https://airhex.com/api/v1/logos/DAL/t/256x256.svg?theme=dark&sig=...",
            "width": 256,
            "height": 256
          },
          "tail_right": {  // Growth+
            "url": "https://airhex.com/api/v1/logos/DAL/f/256x256.svg?theme=dark&sig=...",
            "width": 256,
            "height": 256
          },
          "rectangular": {
            "url": "https://airhex.com/api/v1/logos/DAL/r/896x256.svg?theme=dark&sig=...",
            "width": 896,
            "height": 256
          }
        }
      }
    }
  ],
  "total": 1
}

Examples

Get airline logo URLs

Retrieve all logo URLs for Delta Air Lines. Response includes signed URLs for every logo variant available on your plan.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.airhex.com/v1/logos?codes=DL"

Response (PNG images):

Square

Circular

Tail

Tail Right

Rectangular

Square

Circular

Tail

Tail Right

Rectangular

Logo URLs with custom height

Request 512 px logos for Emirates. Square, circular, and tail logos will be 512×512, rectangular will be 1792×512 (3.5 : 1 ratio).

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.airhex.com/v1/logos?codes=EK&height=512"

Response (PNG images):

Square

Circular

Tail

Tail Right

Rectangular

Square

Circular

Tail

Tail Right

Rectangular

Logo URLs with small height

Request compact 100 px logos for Lufthansa. Rectangular will be 350×100.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.airhex.com/v1/logos?codes=LH&height=100"

Response (PNG images):

Square

Circular

Tail

Tail Right

Rectangular

Square

Circular

Tail

Tail Right

Rectangular

Multi-code logo lookup (Growth & Enterprise)

Retrieve logo URLs for multiple airlines in a single request.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.airhex.com/v1/logos?codes=DL,AA,EK,LH,SQ"

Use a signed logo URL directly

The URLs returned by the logos endpoint can be used directly in HTML. No authentication header needed — the signature in the URL authorizes access.

# 1. Get the URLs
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.airhex.com/v1/logos?codes=DL"

# 2. Use the signed URL in HTML:
# <img src="https://api.airhex.com/v1/logos/DAL/s/256x256.png?sig=a1b2c3d4e5f6" />

Error Codes

Code	Description
`400`	Bad request — invalid size or dimensions
`401`	Unauthorized — missing or invalid API key. Check your Authorization header.
`403`	Forbidden — your plan does not permit this operation (e.g. unsupported format, logo type, dark theme, or size exceeds plan limits)
`404`	Not found — no matching airline for the given code
`429`	Too many requests — per-second rate limit exceeded. Back off and retry.
`502`	Bad gateway — a temporary error occurred. 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.

Legacy API — This documents the previous AirHex API (content.airhex.com). It remains operational for existing integrations but new projects should use the Current API.

Step 1: Define Airline Logo URL Structure

PNG, GIF, JPEG logos:

https://content.airhex.com/content/logos/airlines_AIRLINECODE_WIDTH_HEIGHT_TYPE.png

(.gif, .jpg also supported)

SVG logos:

https://content.airhex.com/content/logos/airlines_AIRLINECODE_TYPE.svg

Where:

AIRLINECODE: 2-letter IATA or 3-letter ICAO airline code (e.g., DL)
WIDTH & HEIGHT (PNG only): Logo dimensions in pixels
TYPE:
- r — Rectangular logo (3.5:1 ratio)
- s — Square logo (1:1 ratio)
- t — Tail logo
- f — Flipped tail logo

Example (PNG):

https://content.airhex.com/content/logos/airlines_DL_350_100_r.png

Step 2: Generate MD5 Hash for API Authentication

Construct a string from your parameters and API key, then generate an MD5 hash.

For PNG, GIF, JPEG logos, the string format is:

AIRLINECODE_WIDTH_HEIGHT_TYPE_APIKEY

Example (PNG):

String for hashing: DL_350_100_r_1234567890
MD5 Hash result: 4c11196e7a8fed18dbf727688ac7cbf5

For SVG logos, the string format is:

AIRLINECODE_TYPE_APIKEY

Example (SVG):

String for hashing: DL_r_1234567890
MD5 Hash result: 266751cb5912092c8d50f69ca7417e77

Step 3: Complete Logo API URL

Add the MD5 hash to your URL as the md5apikey parameter.

PNG, GIF, JPEG:

https://content.airhex.com/content/logos/airlines_AIRLINECODE_WIDTH_HEIGHT_TYPE.png?md5apikey=MD5_HASH

SVG:

https://content.airhex.com/content/logos/airlines_AIRLINECODE_TYPE.svg?md5apikey=MD5_HASH

Example URLs:

https://content.airhex.com/content/logos/airlines_DL_350_100_r.png?md5apikey=4c11196e7a8fed18dbf727688ac7cbf5
https://content.airhex.com/content/logos/airlines_DL_r.svg?md5apikey=266751cb5912092c8d50f69ca7417e77

Note: SVG logos require an active license.

Step 4: Optional Parameters

Dark Theme Logo

Use the theme=dark parameter to get a logo optimized for dark backgrounds. Alternatively, use dark=1 for the same effect.

https://content.airhex.com/content/logos/airlines_DL_350_100_r.png?theme=dark

Available values: theme=light (default) or theme=dark.

Maintain Aspect Ratio

Use the proportions=keep parameter to preserve the logo's original aspect ratio:

https://content.airhex.com/content/logos/airlines_DL_700_100_r.png?proportions=keep

Custom Background Color

Use the background=hexcolor parameter to define a custom logo background color:

https://content.airhex.com/content/logos/airlines_DL_350_100_r.png?background=3399cc

Ready to integrate airline logos?

Get your API key and start querying airline logos in minutes.

Get Started

Trusted by leading aviation & travel companies

Airline Logos API Reference

On this page

API Reference

Authentication

Parameters

Response Fields

Response Example

Examples

Get airline logo URLs

Logo URLs with custom height

Logo URLs with small height

Multi-code logo lookup (Growth & Enterprise)

Use a signed logo URL directly

Error Codes

Rate Limits

Step 1: Define Airline Logo URL Structure

Step 2: Generate MD5 Hash for API Authentication

Step 3: Complete Logo API URL

Step 4: Optional Parameters

Dark Theme Logo

Maintain Aspect Ratio

Custom Background Color

Ready to integrate airline logos?