A simple API developed to allow avgeeks to easily utilise the ICAO24 hex code or callsign to obtain detailed information about aircraft flying over their ADS-B radar. See it in action on a custom radar webpage.

Last updated automatically 30/11/2023 00:01:36.

RESTful

Aircraft Info
Endpoint

GET https://hexdb.io/api/v1/aircraft/{hex}

Examples

GET https://hexdb.io/api/v1/aircraft/4010ee

Response

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

GET https://hexdb.io/api/v1/aircraft/000000

Response

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

Route Info
Endpoint

GET https://hexdb.io/api/v1/route/icao/{callsign}

GET https://hexdb.io/api/v1/route/iata/{callsign}

Examples

GET https://hexdb.io/api/v1/route/icao/EIN17A

Response

{"flight":"EIN17A","route":"EIDW-EGLL","updatetime":1397991739}

GET https://hexdb.io/api/v1/route/icao/ABC123

Response

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

Airport Info
Endpoint

GET https://hexdb.io/api/v1/airport/icao/{icao}

GET https://hexdb.io/api/v1/airport/iata/{iata}

Examples

GET https://hexdb.io/api/v1/airport/icao/EGLL

Response

{"airport":"Heathrow Airport","country_code":"GB","iata":"LHR","icao":"EGLL","latitude":51.4706,"longitude":-0.461941,"region_name":"England"}

GET https://hexdb.io/api/v1/airport/icao/AAAA

Response

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

Simple

Aircraft Info

Hex Conversions

Various conversions using the ICAO/Mode-S hex.

Hex - Registration

https://hexdb.io/hex-reg?hex=<HEX>

Hex - Type

https://hexdb.io/hex-type?hex=<HEX>

Hex - Airline

https://hexdb.io/hex-airline?hex=<HEX>

Registration - Hex

https://hexdb.io/reg-hex?reg=<REG>

Route Info

Callsign Conversions

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

ICAO - Route

https://hexdb.io/callsign-route?callsign=<CALLSIGN>

IATA - Route

https://hexdb.io/callsign-route-iata?callsign=<CALLSIGN>

ICAO - Destination

https://hexdb.io/callsign-des_icao?callsign=<CALLSIGN>

IATA - Destination

https://hexdb.io/callsign-des_iata?callsign=<CALLSIGN>

ICAO - Origin

https://hexdb.io/callsign-origin_icao?callsign=<CALLSIGN>

IATA - Origin

https://hexdb.io/callsign-origin_iata?callsign=<CALLSIGN>

Airport Info

ICAO/IATA Conversions

Converting IATA/ICAO airport codes.

IATA - Airport Name

https://hexdb.io/iata-airport?iata=<IATA>

ICAO - Airport Name

https://hexdb.io/icao-airport?icao=<ICAO>

IATA - ICAO

https://hexdb.io/iata-icao?iata=<IATA>

ICAO - IATA

https://hexdb.io/icao-iata?icao=<ICAO>

Images

Image Retrieval

Retrieve images of aircraft using the ICAO/Mode-S hex.

Hex - Image

https://hexdb.io/hex-image?hex=<HEX>

Hex - Image Thumbnail

https://hexdb.io/hex-image-thumb?hex=<HEX>

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

Any questions? Get in touch - [email protected]