AeroModel

AeroModel

Documentation

GET /v1/catalog/*

Three endpoints to browse the catalog: aircraft, airlines, and available liveries.

GET /v1/catalog/planes

Search the list of aircraft models.

Parameters

ParamDefaultDescription
query(empty)Substring filter on name, slug, IATA, ICAO
limit50Max results (1-200)

Examples

GET https://api.aeromodel.dash-systems.fr/v1/catalog/planes?api-key=YOUR_KEY&query=a320&limit=10

{
  "items": [
    { "slug": "airbus-a320-200", "name": "Airbus A320-200", "iata": "320", "icao": "A320" },
    { "slug": "airbus-a320neo", "name": "Airbus A320neo", "iata": "32N", "icao": "A20N" },
    { "slug": "airbus-a321-200", "name": "Airbus A321-200", "iata": "321", "icao": "A321" }
  ],
  "total": 3
}

GET /v1/catalog/airlines

Search the list of airlines.

Parameters

ParamDefaultDescription
query(empty)Substring filter on name, slug, IATA, ICAO
limit50Max results (1-200)
plane / plane_iata / plane_icao(empty)If provided, only returns airlines that have at least one livery for that aircraft

Examples

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

Filtered by aircraft:

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

→ returns only airlines operating an A380 (Emirates, Etihad, Singapore Airlines, etc.).

GET /v1/catalog/liveries

Lists liveryType values available for a Plane + Airline pair.

Parameters

ParamDescription
plane / plane_iata / plane_icaoRequired — resolves the aircraft
airline / airline_iata / airline_icaoRequired — resolves the airline
limit50

Example

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

{
  "plane": { "slug": "airbus-a380-800" },
  "airline": { "slug": "emirates" },
  "items": [
    { "liveryType": "base", "available": true },
    { "liveryType": "expo-2020", "available": true },
    { "liveryType": "real-madrid", "available": true }
  ]
}

Errors

CodeCase
400plane or airline missing / unresolved
401No API key

See also