API quickstart

curl https://data.flightportrait.com/v2/point/1.3521/103.8198/15

{"ac": [{"hex": "7805dc", "flight": "CKK288", "t": "B77L", "r": "B-2076",
         "lat": 1.387344, "lon": 104.007336, "alt_baro": 7225, "gs": 287.2,
         "track": 340.05, "dst": 11.5, ...}, ...],
 "now": 1790407220.35, "total": 2}

curl https://data.flightportrait.com/v1/flights/SIA322

{"callsign": "SIA322", "route": ["SIN", "LHR"], "route_source": "observed",
 "legs": [{"org": "SIN", "dst": "LHR", "dep": "23:00", ...}], ...}

curl -L "https://data.flightportrait.com/v1/search?q=SIN%20LHR"

{"q": "SIN LHR", "results": [
  {"kind": "flight", "id": "BAW16", "label": "BAW16",
   "detail": "SIN → LHR · 48 flights", "score": 46.8}, ...]}

import json
import urllib.parse
import urllib.request

API = "https://data.flightportrait.com"
HEADERS = {"User-Agent": "my-sky-script/1.0 ([email protected])"}


def get(path):
    request = urllib.request.Request(API + path, headers=HEADERS)
    with urllib.request.urlopen(request, timeout=10) as response:
        return json.load(response)


# What is flying within 15 nautical miles of a point, nearest first
sky = get("/v2/point/1.3521/103.8198/15")
for ac in sky["ac"]:
    print(ac.get("flight", ac["hex"]), ac.get("t"), ac.get("alt_baro"), f'{ac["dst"]} nm')

# One flight: where it goes, when it usually leaves
flight = get("/v1/flights/SIA322")
print(flight["route"], flight["legs"][0]["dep"])

# Search, as a person would type it
found = get("/v1/search?" + urllib.parse.urlencode({"q": "SIN LHR"}))
for result in found["results"]:
    print(result["kind"], result["id"], result["label"], result["detail"])

AIQ356 A21N 11150 11.1 nm
CKK288 B77L 4425 12.6 nm
MXD158 B38M 38000 14.0 nm
['SIN', 'LHR'] 23:00
flight BAW16 BAW16 SIN → LHR · 48 flights
flight SIA306 SIA306 SIN → LHR · 47 flights

const API = "https://data.flightportrait.com";

async function get(path) {
  const response = await fetch(API + path);
  if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
  return response.json();
}

// What is flying within 15 nautical miles of a point, nearest first
const sky = await get("/v2/point/1.3521/103.8198/15");
for (const ac of sky.ac) {
  console.log(ac.flight ?? ac.hex, ac.t, ac.alt_baro, `${ac.dst} nm`);
}

// One flight: where it goes, when it usually leaves
const flight = await get("/v1/flights/SIA322");
console.log(flight.route, flight.legs[0].dep);

// Search, as a person would type it
const found = await get("/v1/search?q=" + encodeURIComponent("SIN LHR"));
for (const r of found.results) console.log(r.kind, r.id, r.label, r.detail);

#include <WiFi.h>
#include <WiFiClientSecure.h>
#include <HTTPClient.h>
#include <ArduinoJson.h>

const char* WIFI_SSID = "your-network";
const char* WIFI_PASS = "your-password";

void setup() {
  Serial.begin(115200);
  WiFi.begin(WIFI_SSID, WIFI_PASS);
  while (WiFi.status() != WL_CONNECTED) delay(250);
}

void loop() {
  WiFiClientSecure tls;
  tls.setInsecure();  // public, read-only data; pin a root CA if you need to
  HTTPClient http;
  http.useHTTP10(true);  // a plain body the parser can stream
  http.setUserAgent("my-esp32/1.0 ([email protected])");
  http.begin(tls, "https://data.flightportrait.com/v2/point/1.3521/103.8198/15");
  if (http.GET() == 200) {
    JsonDocument filter;  // keep only what we print
    JsonObject f = filter["ac"].add<JsonObject>();
    f["flight"] = f["t"] = f["alt_baro"] = f["dst"] = true;
    JsonDocument doc;
    deserializeJson(doc, http.getStream(), DeserializationOption::Filter(filter));
    for (JsonObject ac : doc["ac"].as<JsonArray>()) {
      if (!ac["alt_baro"].is<long>()) continue;  // "ground"
      Serial.printf("%s %s %ld ft %.1f nm\n", ac["flight"] | "?", ac["t"] | "?",
                    ac["alt_baro"].as<long>(), ac["dst"].as<float>());
      break;
    }
  }
  http.end();
  delay(30000);
}

Data (c) FlightPortrait network feeders and credited sources. Live data CC BY-NC 4.0 (non-commercial); routes and history ODbL 1.0