Adsbdb
public api for aircraft, airlines, & flightroutes
Install / Use
/learn @mrjackwills/AdsbdbREADME
GET Routes
https://api.adsbdb.com/v[semver.major]/aircraft/[MODE_S || REGISTRATION]
<br>or<br>
https://api.adsbdb.com/v[semver.major]/aircraft/random
{
"response":{
"aircraft":{
"type": string,
"icao_type": string,
"manufacturer": string,
"mode_s": string,
"registration": string,
"registered_owner_country_iso_name": string,
"registered_owner_country_name": string,
"registered_owner_operator_flag_code": string || null,
"registered_owner": string,
"url_photo": string || null,
"url_photo_thumbnail": string || null
}
}
}
Unknown aircraft return status 404 with
{ "response": "unknown aircraft"}
https://api.adsbdb.com/v[semver.major]/callsign/[CALLSIGN]
<br>or<br>
https://api.adsbdb.com/v[semver.major]/callsign/random
{
"response": {
"flightroute":{
"callsign": string,
"callsign_icao": string || null,
"callsign_iata": string || null,
"airline": {
"name": string,
"icao": string,
"iata": string || null,
"country": string,
"country_iso": string,
"callsign": string || null
} || null,
"origin": {
"country_iso_name": string,
"country_name": string,
"elevation": number,
"iata_code": string,
"icao_code": string,
"latitude": number,
"longitude": number,
"municipality": string,
"name": string,
},
"destination": {
"country_iso_name": string,
"country_name": string,
"elevation": number,
"iata_code": string,
"icao_code": string,
"latitude": number,
"longitude": number,
"municipality": string,
"name": string,
}
}
}
}
For a small number of flightroutes, midpoints are also included
{
"midpoint": {
"country_iso_name": string,
"country_name": string,
"elevation": number,
"iata_code": string,
"icao_code": string,
"latitude": number,
"longitude": number,
"municipality": string,
"name": string,
}
}
Unknown callsign return status 404 with
{ "response": "unknown callsign"}
https://api.adsbdb.com/v[semver.major]/aircraft/[MODE_S || REGISTRATION]?callsign=[CALLSIGN]
{
"response": {
"aircraft":{
"type": string,
"icao_type": string,
"manufacturer": string,
"mode_s": string,
"registration": string,
"registered_owner_country_iso_name": string,
"registered_owner_country_name": string,
"registered_owner_operator_flag_code": string || null,
"registered_owner": string,
"url_photo": string || null,
"url_photo_thumbnail": string || null
},
"flightroute":{
"callsign": string,
"callsign_icao": string || null,
"callsign_iata": string || null,
"airline": {
"name": string,
"icao": string,
"iata": string || null,
"country": string,
"country_iso": string,
"callsign": string || null
} || null,
"origin": {
"country_iso_name": string,
"country_name": string,
"elevation": number,
"iata_code": string,
"icao_code": string,
"latitude": number,
"longitude": number,
"municipality": string,
"name": string,
},
"destination": {
"country_iso_name": string,
"country_name": string,
"elevation": number,
"iata_code": string,
"icao_code": string,
"latitude": number,
"longitude": number,
"municipality": string,
"name": string,
}
}
}
}
If an unknown callsign is provided as a query param, but the aircraft is known, response will be status 200 with just aircraft
https://api.adsbdb.com/v[semver.major]/airline/[AIRLINE_ICAO || AIRLINE_IATA ]
<br>or<br>
https://api.adsbdb.com/v[semver.major]/airline/random
{
"response":{
[
{
"name": string,
"icao": string,
"iata": string || null,
"country": string,
"country_iso": string,
"callsign": string || null
},
...
]
}
}
Unknown airline return status 404 with
{ "response": "unknown airline"}
https://api.adsbdb.com/v[semver.major]/stats
{
"response": {
"daily": {
"aircraft": [
{
"url": string,
"count": number
}
],
"airline": [
{
"url": string,
"count": number
}
],
"callsign": [
{
"url": string,
"count": number
}
],
"mode_s": [
{
"url": string,
"count": number
}
],
"n_number": [
{
"url": string,
"count": number
}
],
"online": [
{
"url": string,
"count": number
}
],
"stats": [
{
"url": string,
"count": number
}
],
"aggregate": number
},
"total": {
"aircraft": [
{
"url": string,
"count": number
}
],
"airline": [
{
"url": string,
"count": number
}
],
"callsign": [
{
"url": string,
"count": number
}
],
"mode_s": [
{
"url": string,
"count": number
}
],
"n_number": [
{
"url": string,
"count": number
}
],
"online": [
{
"url": string,
"count": number
}
],
"stats": [
{
"url": string,
"count": number
}
],
"aggregate": number
}
}
}
Convert from MODE-S string to N-Number string
https://api.adsbdb.com/v[semver.major]/mode-s/[MODE_S]
{ "response": string }
Convert from N-Number string to Mode_S string
https://api.adsbdb.com/v[semver.major]/n-number/[N-NUMBER]
{ "response": string }
PATCH Routes
When env.allow_update is correctly set, and the PATCH request contains a valid Authorization header, Aircraft and Callsign can be modified.
https://api.adsbdb.com/v[semver.major]/aircraft/[MODE_S]
{
"type": string,
"icao_type": string,
"manufacturer": string,
"mode_s": string,
"registration": string,
"registered_owner_country_iso_name": string,
"registered_owner_country_name": string,
"registered_owner_operator_flag_code": string || null,
"registered_owner": string,
"url_photo": string || null,
"url_photo_thumbnail": string || null
}
Warning: mode_s, url_photo, and url_photo_thumbnail cannot be modified.
https://api.adsbdb.com/v[semver.major]/callsign/[CALLSIGN]
{
"origin": string,
"destination": string
}
Warning: Both origin and destination need to be valid ICAO airport codes.
Download
See <a href="https://github.com/mrjackwills/adsbdb/releases" target='_blank' rel='noopener noreferrer'>releases</a>
download one liner
wget https://www.github.com/mrjackwills/adsbdb/releases/latest/download/adsbdb_linux_x86_64.tar.gz &&
tar xzvf adsbdb_linux_x86_64.tar.gz adsbdb
Run
Operate docker compose containers via
./run.sh
Build
cargo build --release
cross build --target x86_64-unknown-linux-musl --release
Tests
Requires both postgres, seeded with data, and redis, operational
# Watch
cargo watch -q -c -w src/ -x 'test -- --test-threads=1 --nocapture'
# Run all
cargo test -- --test-threads=1 --nocapture
Related Skills
himalaya
347.9kCLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
node-connect
347.9kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
taskflow
347.9kname: taskflow description: Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layer
frontend-design
108.7kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
