Usage notes

Code snippets

curl "https://api.oanor.com/vatsim-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/vatsim-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/vatsim-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/vatsim-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Live data from VATSIM, the largest online flight-simulation network of virtual pilots and air-traffic controllers. /v1/pilots = the pilots currently flying online, each with live position (lat/lon, altitude, ground speed, heading), aircraft and flight plan (departure, arrival, route, cruise altitude); filter by airport (departure or arrival ICAO, e.g. airport=EDDF) or by callsign prefix. /v1/controllers = the air-traffic controllers currently online, each with callsign, frequency, facility (Tower, Approach, Center, …) and rating; filter by airport prefix (e.g. airport=EGLL matches EGLL_TWR, EGLL_APP), and set observers=true to include observers. /v1/stats = the network status — total connected clients and the counts of pilots, controllers and ATIS online, with the snapshot timestamp. This is the live flight-simulation network — distinct from real-world ADS-B flight tracking. Data from VATSIM (free; please credit VATSIM). Snapshots update about every 15 seconds. Ideal for flight-sim tools, online-ATC maps and community dashboards.",
        "source": "VATSIM — Virtual Air Traffic Simulation Network (data.vatsim.net)",
        "endpoints": [
            "/v1/pilots",
            "/v1/controllers",
            "/v1/stats",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T16:23:22.978Z",
        "request_id": "4ce5586b-2391-40a9-badf-affa1b55ca11"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}