API Documentation

Base URL

https://aerosearch.wingle.cc/api

Airport API

Get airport information by IATA or ICAO code

GET/api/airport?code=JFK

Parameters

NameTypeRequiredDescription
codestringYesAirport IATA or ICAO code (e.g., JFK, KLAX, EGLL)

Example Response

{
  "iata": "JFK",
  "icao": "KJFK",
  "city": "New York",
  "name": "John F Kennedy International Airport",
  "country": "US",
  "latitude": 40.639447,
  "longitude": -73.779317
}

Error Responses

400 Bad Request

When airport code is missing or invalid

404 Not Found

When no airport is found with the given code

Airline API

Get airline information by IATA or ICAO code

GET/api/airline?code=nbt

Parameters

NameTypeRequiredDescription
codestringYesAirline IATA or ICAO code (e.g., DL, DAL, AA, AAL)

Example Response

{
  "icao": "NBT",
  "iata": "N0",
  "name": "Norse",
  "prefix": "",
  "callsign": "",
  "country": "NO",
  "status": "active",
  "logo_url": "/img/airlines/nbt.png",
  "alliance": "",
  "destinations": 0,
  "fleet": [
    {
      "aircraft": "B789",
      "count": 11
    }
  ],
  "airplanes": [
    {
    "reg": "LN-FNL",
    "model": "B789",
    "photo_link": "https://cdn.jetphotos.com/full/5/1025153_1742852427.jpg"
    },
    {
    "reg": "LN-LNR",
    "model": "B789",
    "photo_link": "https://cdn.jetphotos.com/full/5/787087_1748799132.jpg"
    },
    {
    "reg": "LN-LNO",
    "model": "B789",
    "photo_link": "https://cdn.jetphotos.com/full/5/562044_1741832596.jpg"
    }
  ]
}

Error Responses

400 Bad Request

When airline code is missing or invalid

404 Not Found

When no airline is found with the given code

Airplane Registration API

Get detailed airplane information by registration number

GET/api/airplane?reg=N632JB

Parameters

NameTypeRequiredDescription
regstringYesThe aircraft registration number (e.g., B6366, N12345)

Example Response

{
  "registration": "N632JB",
  "model": "A320",
  "airline": "JetBlue Airways",
  "photo_link": "https://cdn.jetphotos.com/full/6/1048144_1749055156.jpg"
}

Error Responses

400 Bad Request

When registration number is missing

404 Not Found

When no airplane is found with the given registration

Airline Logo Images

Get airline logo by IATA code

GET/img/airlines/DL.png

Country Flag Images

Get country flags in different styles using 2-letter country codes

Rectangular Flags

GET/img/countries/reg/us.png

Waving Flags

GET/img/countries/wave/us.png

Round Flags

GET/img/countries/round/us.png

Replace the country code in the URL with any valid 2-letter ISO 3166-1 alpha-2 country code (e.g., us, gb, jp, cn, etc.)

Health Check

Check if the API is running

GET/api/healthz