Ecosystem
Files and APIs
jsDelivr CDN
Link any mark straight from the npm package, with nothing to install. The slug is the airline’s name in lowercase with hyphens, like vietnam-airlines.
https://cdn.jsdelivr.net/npm/soaring-symbols/dist/assets/<slug>/logo.svgicon, tail, logo-stacked- The other marks, in place of logo; logo-stacked is the vertical lockup, for airlines that have one.
-mono, -dark- Before .svg: the monochrome mark, or the one for dark backgrounds.
<slug>/history/<year>/- Older logos, by the year each came in.
soaring-symbols@0.5- A release line, for fixes without breaking changes; pin an exact release to keep files as they are.
<old slug>/- A renamed airline’s old slug shows its current marks.
unpkg CDN
The same files from the npm package on another CDN, at the same paths, so either one can stand in for the other.
https://unpkg.com/soaring-symbols/dist/assets/<slug>/logo.svgsoaring-symbols@0.5- Redirects to the newest release in the line within minutes of publishing.
dist/index.js- The library as an ES module, for pages without a bundler.
?module- Imports the SVG fixer, which then loads its resvg dependency from unpkg too.
JSON API
Look up an airline and get its codes, callsign, hubs, brand colors, history and links to every SVG, or an alliance and its marks. Open to any site, no key needed.
https://soaringsymbols.org/api/airlines/VN/api/airlines- Every airline, with the package version and a count.
?code=<code>- Every airline holding an IATA or ICAO code, such as SL for Thai Lion Air and SAS Connect; add &former=true for those that held it before.
?cargo=true- Only the cargo airlines and the cargo brands of passenger airlines, such as Cargolux; cargo=false leaves them out. Works with ?code= too.
/api/airlines/<code>- One airline by IATA or ICAO code, slug or name, current or former, or another name it goes by (SWISS); a 404 with a hint when nothing matches.
former, history- A renamed airline’s former names, and the years each older logo was used.
/api/alliances- Every alliance; /api/alliances/<name> takes a name or slug, such as skyteam, with its slogan, years, color and marks.
Image API
Load any airline’s mark by IATA or ICAO code, or an alliance’s by name, as SVG or as PNG for apps that can’t render SVG, with monochrome marks in the color you pick.
https://soaringsymbols.org/api/airlines/VN/icon-mono.png?color=fff&size=128<file>- logo, logo-stacked, icon or tail, with -mono for the monochrome mark or -dark for dark backgrounds, ending in .svg or .png.
?color=- A hex color for a monochrome mark, such as fff.
?dark=- The color a monochrome SVG switches to in dark mode.
?size=- The PNG width in pixels, from 16 to 1024 (256 by default).
/api/alliances/<slug>/- Alliance marks, the same way, with icon and logo files.
Apps and plugins
- Raycast extension
Search airlines from your launcher, see their codes, hubs and history, and grab their SVGs, earlier logos included. Also works in Vicinae, SuperCmd and Tinycast, which run Raycast extensions.
Open in Raycast Store - Figma plugin In review
Search airlines by name or code in Figma or FigJam, and click or drag their marks onto the canvas as vector layers, earlier logos included, with monochrome marks in any color.
View on GitHub