Data sources and coverage
DisruptAPI builds signals from 93 official and open sources and no data partners. This page summarises coverage, explains how to check freshness through the API, and lists the attribution and licence terms you should respect. The full list with methodology is on the Data sources page.
What does DisruptAPI cover?#
| Area | Sources |
|---|---|
| Airports and airspace | FAA NAS status (US ground stops, delay programs, closures), EASA conflict-zone bulletins, international SIGMETs, METAR weather at about 5,000 airports |
| Weather warnings | Meteoalarm (38 European countries), US NWS, Environment Canada and other national CAP feeds; NHC tropical cyclones |
| Natural hazards | GDACS, USGS earthquakes (M6.0 and above), NIFC wildfire perimeters (US) |
| Travel advisories | 6 governments: US, UK, Canada, Australia, Germany, Netherlands |
| Unrest, conflict and strikes | GDELT news events, clustered by place and raised on a burst against the place's own baseline (news-derived) |
| IT and cloud | Status of 15 cloud and SaaS providers, including AWS, Azure, Google Cloud, Microsoft 365, Salesforce and Statuspage vendors |
| Internet, health, launches, GPS | IODA country connectivity, CDC travel health notices, Launch Library 2 rocket launches near airports, adsb.lol GPS interference over eight regions |
DisruptAPI does not report the status of individual flights, and does not use paid flight data.
Known gaps#
- Official weather warnings are missing for much of Asia, Africa and Latin America, where no feed has a usable licence. METAR airport weather is the fallback there.
- Some warnings can only be placed at country level, because their area names could not be matched to airports. Exposure results say so in the reason.
- Forecast outcomes are measured mainly in the US (BTS, FAA). Elsewhere history is thinner, which
nandlow_confidenceshow. - GPS interference depends on adsb.lol receiver coverage: good over the Baltic and the Gulf, thin over Iraq and the Black Sea.
- News-derived signals are evidence, not confirmation. They are labelled
details.basis: "news".
How fresh is the data?#
Each source is checked on its own interval, from every 2 minutes for fast feeds such as FAA airport status to once a day for slow ones. Each signal says when its source was last read successfully and whether that is too long ago:
{
"source": {
"url": "https://nasstatus.faa.gov/",
"attribution": "FAA NAS Status",
"last_checked_at": "2026-11-18T07:21:02Z",
"stale": false
}
}- A source is stale when it has not been read successfully for longer than its limit, by default four times its interval. The FAA feed, checked every 2 minutes, is stale after 8.
- Signals from a stale source stay as they were last seen. They may have changed or ended. See handling stale sources.
- Ended signals are never served as active: a signal past its
ends_atis resolved within about a minute.
The source register#
GET /v1/sources lists every source with its publisher, coverage, licence, the attribution to show, how often it is checked and its freshness right now. Use it for procurement reviews, or to decide which signals suit your use.
curl "https://app.disruptapi.com/v1/sources" \
-H "Authorization: Bearer $DISRUPT_KEY"// Node.js 18+ (built-in fetch), saved as an .mjs file
const res = await fetch("https://app.disruptapi.com/v1/sources", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.DISRUPT_KEY}`,
},
signal: AbortSignal.timeout(30_000),
});
const json = await res.json();
if (!res.ok) {
throw new Error(`${res.status} ${json.error.code}: ${json.error.message}`);
}
console.log(JSON.stringify(json.data, null, 2));import os
import requests
resp = requests.get(
"https://app.disruptapi.com/v1/sources",
headers={"Authorization": f"Bearer {os.environ['DISRUPT_KEY']}"},
timeout=30,
)
if not resp.ok:
err = resp.json()["error"]
raise SystemExit(f"{resp.status_code} {err['code']}: {err['message']}")
print(resp.json()["data"])import os
import httpx
with httpx.Client(
base_url="https://app.disruptapi.com",
headers={"Authorization": f"Bearer {os.environ['DISRUPT_KEY']}"},
timeout=30,
) as client:
resp = client.get("/v1/sources")
if resp.is_error:
err = resp.json()["error"]
raise SystemExit(f"{resp.status_code} {err['code']}: {err['message']}")
print(resp.json()["data"])package main
import (
"fmt"
"io"
"log"
"net/http"
"os"
"time"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://app.disruptapi.com/v1/sources", nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("DISRUPT_KEY"))
client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
out, err := io.ReadAll(resp.Body)
if err != nil {
log.Fatal(err)
}
fmt.Println(resp.StatusCode, string(out))
}require "json"
require "net/http"
require "uri"
uri = URI("https://app.disruptapi.com/v1/sources")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch("DISRUPT_KEY")}"
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, open_timeout: 10, read_timeout: 30) do |http|
http.request(req)
end
json = JSON.parse(res.body)
abort "#{res.code} #{json["error"]["code"]}: #{json["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
puts JSON.pretty_generate(json["data"])<?php
$ch = curl_init("https://app.disruptapi.com/v1/sources");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("DISRUPT_KEY"),
],
]);
$raw = curl_exec($ch);
if ($raw === false) {
exit("request failed: " . curl_error($ch) . PHP_EOL);
}
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$json = json_decode($raw, true);
if ($status >= 400) {
exit("{$status} {$json['error']['code']}: {$json['error']['message']}" . PHP_EOL);
}
print_r($json["data"]);// Java 17+. Run with: java Main.java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://app.disruptapi.com/v1/sources"))
.timeout(Duration.ofSeconds(30))
.header("Authorization", "Bearer " + System.getenv("DISRUPT_KEY"))
.GET()
.build();
HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(10)).build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}// .NET 7+ console app (top-level statements, C# 11 raw strings)
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("DISRUPT_KEY"));
using var response = await http.GetAsync("https://app.disruptapi.com/v1/sources");
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());{
"data": [
{
"id": "launch_library",
"name": "Launch Library 2",
"publisher": "The Space Devs",
"signal_types": ["aviation"],
"coverage": "Rocket launches worldwide in the next 48 hours, at pads within 150 km of an airport",
"licence": {
"name": "Launch Library 2 terms: commercial use allowed when the data is part of a value-adding service",
"url": "https://thespacedevs.com/llapi",
"commercial_use": "open_licence"
},
"attribution": "The Space Devs Launch Library 2",
"feeds": 1,
"checked_every_s": 1800,
"last_checked_at": "2026-11-18T07:00:12Z",
"stale_feeds": 0,
"status": "ok"
}
]
}status is ok, degraded (some of the source's feeds are stale) or stale (all are).
What attribution and licences must I respect?#
If you show signals to your own users or customers:
- Show
source.attributionand link tosource.urlnext to the signal, or in a credits section close to it. Several licences (CC BY, ODbL, Meteoalarm's terms) require it. - Keep disclaimers that are part of the attribution, such as "indicative only" for GDACS and "derived from news reports; not an official warning" for GDELT-based signals.
- Do not present news-derived signals as official warnings, and do not present forecasts as predictions for a specific flight.
- Do not resell the raw data as a feed. Several sources allow commercial use only as part of a value-adding service. Your plan's terms apply to how you redistribute signals.
Each register entry's licence.commercial_use is one of:
| Value | Meaning |
|---|---|
public_domain | No restriction, e.g. US federal sources. Attribution is still good practice. |
open_licence | An open licence such as CC BY or ODbL. Show the attribution as given; share-alike licences apply to databases you derive from them. |
facts_only | A vendor's website terms, e.g. status pages. DisruptAPI reports facts (timing, what is affected, status) and links to the original, not its text. |
under_review | Terms for commercial redistribution are not yet confirmed. Check licence.url before building a product on these signals alone. |
This page is a summary, not legal advice. For a source you rely on heavily, read its licence at licence.url.
Last updated 2026-11-18. Questions or a mistake on this page? Contact us.