Mode-S Hex API

A simple API developed to allow avgeeks to easily utilise the 24-bit ICAO 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.

Get Started   Support Project

3.1M+

Requests Daily

16/10/26

Database Updated

99.95%

Uptime

  News & Updates

08/09/2026

Please do not scrape the database. While the database is updated daily, upstream changes only happen monthly. All data sources can be found in the footer. If users make an excessive number of requests in a short period of time, IP addresses may be blocked. Caching has now been implemented so a larger number of requests will be tolerated.

08/07/2026

You can now submit corrections for incorrect aircraft, airport, or route data. Spotted something wrong? Submit a correction and it'll be reviewed and applied.

RESTful Images Legacy

RESTful

Aircraft Information
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 Information
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 Information
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."}

Images

Aircraft 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>

Legacy

Aircraft Information

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 Information

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 Information

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>

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

Any questions? Get in touch - [email protected]