AeroModel

AeroModel

Documentation

liveryType

Livery variant for an airline. Default is base (standard livery).

Values

ValueDescription
base (default)Airline's current standard livery
<special-slug>Special livery (retro, partnership, event)
blankAircraft without livery (equivalent to omitting airline)

Available liveryType values depend on the Plane + Airline pair. List them:

GET https://api.aeromodel.dash-systems.fr/v1/catalog/liveries?api-key=YOUR_KEY&plane=A380&airline=EK

Behavior

  1. Requested livery is searched.
  2. If absent → fallback to base (x-fallback-reason: livery-unavailable).
  3. If base absent → fallback to blank.
  4. If blank absent → fallback default image.

The actually applied liveryType is exposed in the x-livery-type header.

API examples

Base (default)

GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A380&airline=EK

A380 Emirates base

Special liveries

The catalog currently ships only base liveries. Special liveries (retro schemes, anniversary paint jobs such as the Lufthansa "100 Years" retro livery, alliance variants, etc.) will be progressively added and exposed via this same parameter.

Copyrighted partnership or entertainment liveries (sports clubs, movie franchises, theme park crossovers, etc.) are intentionally not distributed through this API.

When you request a non-existent liveryType, the API automatically falls back to base:

GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A380&airline=EK&liveryType=retro

→ returns Emirates base livery with headers:

x-livery-type: base
x-fallback-reason: livery-unavailable

Non-existent livery → fallback to base

GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A380&airline=EK&liveryType=does-not-exist

→ returns Emirates base livery with headers:

x-livery-type: base
x-fallback-reason: livery-unavailable

Naming conventions

Lowercase slugs separated by hyphens. Typical examples:

  • base
  • retro, retro-1990
  • partnership-<sponsor>
  • event-<name>
  • oneworld, staralliance (alliances)

See also