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

1.1M+

Requests Daily

08/07/26

Database Updated

99.95%

Uptime

  News & Updates

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.

04/06/2026

Due to an increase in users scraping the database, an IP block for abusive IPs has been applied. Please ensure you are submitting no more than 1000 requests every 5 minutes. If you require a higher rate limit or wish to be unblocked, please get in touch.

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]