Airline logos API

NOTE: This is the endpoint for dynamic airline square, rectangular, and tail new! logo generation with output in PNG, SVG, GIF, and JPEG file format. A list of other endpoints available here: https://airhex.com/api/

Don't have an API key for airline logos but want a try?

Get Started

Airline logo API endpoint with output as PNG files (SVG/vector manual in the next section)


[PNG logos] Step 1/3: Define the airline, logo dimensions and shape (rectangular/square/tail) to build a link to a logo image

The structure is as follows:

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

Where 'AIRLINECODE' is 2 char airline IATA code or 3 char airline ICAO code, 'WIDTH' is the width in pixels, 'HEIGHT' is the height in pixels, 'TYPE' is the type of a logo:
'r' for rectangular logos with 3.5:1 sides ratio;
's' for square logos (1:1 sides);
't' for tail logos (1:1 sides);
'f' for flipped tail logos (1:1 sides)

For example:

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

Where 'SU' is the airline IATA code, '350' is the width in pixels, '150' is the height in pixels, 'r' is for the rectangular type of a logo (or use 's' to fetch a square logo and 't' or 'f' for tail logos)

How to maintain aspect ratio for rectangular logos

All rectangular logos are designed with 3.5:1 sides ratio, however when requesting images with different sides ratio and to keep original aspect ratio proportions=keep GET parameter should be used

For example:

https://content.airhex.com/content/logos/airlines_SU_700_100_r.png?proportions=keep will output the following:

example of a logo with fixed proportions


While https://content.airhex.com/content/logos/airlines_SU_700_100_r.png (without 'proportions=keep') will output:

example of a logo without fixed proportions


It's not required to use the parameter when image sides ratio in the reqyest is 3.5:1, for example 350x100:

https://content.airhex.com/content/logos/airlines_SU_350_100_r.png (without 'proportions=keep') will output:

example of a logo with optimal proportions


Setting a logo background

The background is set as transparent by default. Once you need to change the background color, please use the following parameter: background=hexcolor where hexcolor is a hex 6-char value of required background color, for example, background=FFFFFF for white, background=000000 for black background, etc. Hash before the color value isn't required.

https://content.airhex.com/content/logos/airlines_SU_350_100_r.png?background=3399cc will output:

example of a logo with a background
[PNG logos] Step 2/3: Create MD5 hash of your query using the following structure

airlinecode_width_height_type_apikey

Use the parameters as described in Step 1 and add your API key at the end of this string and then generate an MD5 hash of this.

For example, MD5 hash for a rectangular logo of SU (Aeroflot) airlines with the dimensions of 350x100 px and API key '1234567890' should be created for the following string:

SU_350_100_r_1234567890

The result of MD5 for this string will be as follows:

4d5669b5107fdc240dba0f03961c48e4

[PNG logos] Step 3/3: Combine the requested URL and MD5 hash of your query.

The final format should be as follows:

https://content.airhex.com/content/logos/airlines_AIRLINECODE_WIDTH_HEIGHT_TYPE.png?md5apikey=MD5(AIRLINECODE_WIDTH_HEIGHT_TYPE_APIKEY)

Combine the first part of the query and MD5 hash and build a final deep link which can be used on your website or mobile app with hotlinking

Complete URL for the example above should be as follows:

https://content.airhex.com/content/logos/airlines_SU_350_100_r.png?md5apikey=4d5669b5107fdc240dba0f03961c48e4

Want to remove watermarks from logos?

Get a license

API endpoint with output as SVG files (vector)

[SVG logos] Step 1/3: Define the airline, logo dimensions and shape (rectangular/square/tail) to build a link to a logo image

The structure is as follows:

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

Where 'AIRLINECODE' is 2 char airline IATA code or 3 char airline ICAO code, 'TYPE' is the type of a logo:
'r' for rectangular logos with 3.5:1 sides ratio;
's' for square logos (1:1 sides);
't' for tail logos (1:1 sides);
'f' for flipped tail logos (1:1 sides)

For example:

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

Where 'SU' is the airline IATA code and 'r' is for the rectangular type of a logo (or use 's' to fetch a square logo and 't' or 'f' for tail logos)

[SVG logos] Step 2/3: Create MD5 hash of your query using the following structure

airlinecode_type_apikey

Use the parameters as described in Step 1 and add your API key at the end of this string and then generate an MD5 hash of this.

For example, MD5 hash for a rectangular logo of SU (Aeroflot) airlines with the dimensions of 350x100 px and API key '1234567890' should be created for the following string:

SU_r_1234567890

The result of MD5 for this string will be as follows:

5d1d9a577a9cbdcbd5d5b5285cf07870

[SVG logos] Step 3/3: Combine the requested URL and MD5 hash of your query.

The final format should be as follows:

https://content.airhex.com/content/logos/airlines_AIRLINECODE_TYPE.svg?md5apikey=MD5(AIRLINECODE_TYPE_APIKEY)

Combine the first part of the query and MD5 hash and build a final deep link which can be used on your website or mobile app with hotlinking

Complete URL for the example above should be as follows:

https://content.airhex.com/content/logos/airlines_SU_r.svg?md5apikey=5d1d9a577a9cbdcbd5d5b5285cf07870

To get a license or to enable vector logos for your account - contact us

Want to enable vector logos for your account?

Get a license