Simple ModeS Hex API

A simple API I created to allow avgeeks to easily obtain detailed information about aircraft flying over their ADS-B radar. No need to deal with comprehensive API documentation or JSON parsing. See it in action on my own custom radar webpage. You can also view a graph of requests to the API.

Last updated March 2021 Updating the databases is a manual process and is done every couple of months. If you notice incorrect data, please email me at josh@joshdouch.me.

REST API New

Aircraft Info
Endpoint

GET https://api.joshdouch.me/api/aircraft/{hex}

Examples

GET https://api.joshdouch.me/api/aircraft/4010ee

Response

{"ModeS":"4010EE","Manufacturer":"Airbus","Type":"A319 111","ICAOTypeCode":"A319","RegisteredOwners":"easyJet Airline","OperatorFlagCode":"EZY"}

GET https://api.joshdouch.me/api/aircraft/000000

Response

{"status":"404","error":"Aircraft not found."}

Simple API

Aircraft Info

ICAO24 Hex - Aircraft Registration

https://api.joshdouch.me/hex-reg.php?hex=PUT_HEX_HERE

ICAO24 Hex - Aircraft Type

https://api.joshdouch.me/hex-type.php?hex=PUT_HEX_HERE

ICAO24 Hex - Aircraft Airline

https://api.joshdouch.me/hex-airline.php?hex=PUT_HEX_HERE

Aircraft Registration - ICAO24 Hex New

https://api.joshdouch.me/reg-hex.php?reg=PUT_REG_HERE

Route Info

Converting a callsign to the aircrafts route (e.g. EGLL-LEBL).

Callsign - Route

https://api.joshdouch.me/callsign-route.php?callsign=PUT_CALLSIGN_HERE

Callsign - Destination(ICAO)

https://api.joshdouch.me/callsign-des_ICAO.php?callsign=PUT_CALLSIGN_HERE

Callsign - Destination(IATA)

https://api.joshdouch.me/callsign-des_IATA.php?callsign=PUT_CALLSIGN_HERE

Callsign - Origin(ICAO)

https://api.joshdouch.me/callsign-origin_ICAO.php?callsign=PUT_CALLSIGN_HERE

Callsign - Origin(IATA)

https://api.joshdouch.me/callsign-origin_IATA.php?callsign=PUT_CALLSIGN_HERE

Airport Info

Converting IATA/ICAO airport codes.

IATA - Airport Name

https://api.joshdouch.me/IATA-airport.php?iata=PUT_IATA_HERE

ICAO - Airport Name

https://api.joshdouch.me/ICAO-airport.php?icao=PUT_ICAO_HERE

IATA - ICAO

https://api.joshdouch.me/IATA-ICAO.php?iata=PUT_IATA_HERE

ICAO - IATA

https://api.joshdouch.me/ICAO-IATA.php?icao=PUT_ICAO_HERE

Images

Getting images of planes using the ICAO hex.

ICAO24 Hex - Image

https://api.joshdouch.me/hex-image.php?hex=PUT_HEX_HERE Subject to rate limits.

ICAO24 Hex - Image Photographer

https://api.joshdouch.me/hex-imagephotographer.php?hex=PUT_HEX_HERE Subject to rate limits.

ICAO24 Hex - Image New

https://api.joshdouch.me/hex-image-v2.php?hex=PUT_HEX_HERE Unlimited

ICAO24 Hex - Image Thumbnail New

https://api.joshdouch.me/hex-image-v2-thumb.php?hex=PUT_HEX_HERE Unlimited

ICAO24 Hex - Airline Logo New

https://api.joshdouch.me/hex-logo.php?hex=PUT_HEX_HERE

Data courtesy of PlaneBase, Jim Mason, Steve Hibberd and Airport-Data