AeroModel

AeroModel

Documentation

airline, airline_iata, airline_icao

Selects the airline whose livery will be applied to the aircraft.

Variants

ParamModeExamples
airlineAuto: slug, IATA, ICAO, fuzzy nameair-france, AF, AFR, Air France
airline_iataStrict IATA (2 letters/digits)AF, EK, UA
airline_icaoStrict ICAO (3 letters)AFR, UAE, UAL

Behavior

  • No airline parameter → blank image (aircraft without livery).
  • Resolved airline → base livery (or specific liveryType if provided).
  • Unresolved airline → blank fallback + header x-fallback-reason: airline-not-found.

API examples

Without airline (blank)

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

Blank A320

Air France (slug)

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

A320 Air France

Emirates (IATA)

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

A380 Emirates

United (ICAO)

GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=B789&airline_icao=UAL

787 United

Unknown airline

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

→ blank image returned, headers:

x-livery-state: blank
x-fallback-reason: airline-not-found

Available airlines

curl -H "x-api-key: YOUR_KEY" \
  "https://api.aeromodel.dash-systems.fr/v1/catalog/airlines?limit=200"

Filtered by aircraft

List only airlines operating an A380:

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

Useful for building a dynamic dropdown on the client side.

See also