Quickstart
This page takes you from no account to a signed webhook in five steps: get a key, list live signals, save a watchlist, check exposure and register a webhook. Each step is one HTTP request.
Before you start#
- An account. Sign up in the console; new accounts start on the Sandbox plan (100 requests a month, 10 a minute, 5 watched items, no webhooks).
- Any HTTP client. There is no SDK to install. Pick a language tab below; your choice is remembered on every page.
1. Create an API key#
In the console, open API keys and create a key. It looks like dk_live_ followed by 32 characters and is shown once. If email verification is switched on for your account, confirm your address first. Export the key so the examples can read it:
export DISRUPT_KEY="dk_live_..."Check that it works. GET /v1/me returns your organisation, plan and key:
curl "https://app.disruptapi.com/v1/me" \
-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/me", {
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/me",
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/me")
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/me", 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/me")
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/me");
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/me"))
.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/me");
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());{
"data": {
"org": {
"id": "org_5c1f0a9e2b7d4c31",
"name": "Acme Travel",
"plan": {
"id": "free",
"name": "Sandbox",
"price_usd_month": 0,
"monthly_requests": 100,
"per_minute": 10,
"webhooks": 0,
"exposure_check": true,
"description": "100 requests a month and 5 watched items, to try the API before choosing a plan.",
"watch_items": 5
}
},
"key": { "id": "key_9a0e47c2d1b3f856", "name": "default" },
"requests_this_month": 1
}
}2. Make your first request#
List the most severe active signals. Filters are optional; this asks for severe and extreme signals, five at a time:
curl "https://app.disruptapi.com/v1/signals?min_severity=severe&limit=5" \
-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/signals?min_severity=severe&limit=5", {
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/signals",
headers={"Authorization": f"Bearer {os.environ['DISRUPT_KEY']}"},
params={"min_severity": "severe", "limit": 5},
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/signals",
params={"min_severity": "severe", "limit": 5},
)
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/signals?min_severity=severe&limit=5", 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/signals?min_severity=severe&limit=5")
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/signals?min_severity=severe&limit=5");
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/signals?min_severity=severe&limit=5"))
.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/signals?min_severity=severe&limit=5");
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());{
"data": [
{
"id": "faa_ground_stop_SEA.k3j9x2m1qa",
"type": "aviation",
"subtype": "ground_stop",
"provider": "faa",
"failure_layer": null,
"failure_layer_label": null,
"title": "Ground Stop Program at SEA: low ceilings",
"severity": "severe",
"status": "active",
"countries": ["US"],
"airports": ["SEA"],
"areas": [],
"location": { "lat": 47.449, "lon": -122.309 },
"starts_at": null,
"ends_at": null,
"first_seen_at": "2026-11-18T06:52:10Z",
"updated_at": "2026-11-18T07:20:41Z",
"version": 2,
"source": {
"url": "https://nasstatus.faa.gov/",
"attribution": "FAA NAS Status",
"last_checked_at": "2026-11-18T07:21:02Z",
"stale": false
},
"details": { "reason": "low ceilings", "End_Time": "8:30 am PST" }
}
],
"meta": { "total": 37, "limit": 5, "offset": 0 }
}Every field is described in Signals. Results are ordered most severe first, then most recently updated.
3. Save a watchlist#
A watchlist holds the things you care about, each with your own id. Create one with its first items. Sandbox accounts can watch 5 items in total.
curl -X POST "https://app.disruptapi.com/v1/watchlists" \
-H "Authorization: Bearer $DISRUPT_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Winter departures",
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z"
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40
}
]
}'// Node.js 18+ (built-in fetch), saved as an .mjs file
const res = await fetch("https://app.disruptapi.com/v1/watchlists", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.DISRUPT_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Winter departures",
items: [
{
id: "BKG-7QX2LM",
kind: "flight",
carrier: "AS",
origin: "SEA",
destination: "HNL",
depart_at: "2026-11-21T08:00:00Z",
},
{
id: "HTL-ALCUDIA",
kind: "place",
label: "Hotel Alcudia",
lat: 39.85,
lon: 3.12,
radius_km: 40,
},
],
}),
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.post(
"https://app.disruptapi.com/v1/watchlists",
headers={"Authorization": f"Bearer {os.environ['DISRUPT_KEY']}"},
json={
"name": "Winter departures",
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z",
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40,
},
],
},
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.post(
"/v1/watchlists",
json={
"name": "Winter departures",
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z",
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40,
},
],
},
)
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 (
"bytes"
"fmt"
"io"
"log"
"net/http"
"os"
"time"
)
func main() {
body := []byte(`{
"name": "Winter departures",
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z"
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40
}
]
}`)
req, err := http.NewRequest(http.MethodPost, "https://app.disruptapi.com/v1/watchlists", bytes.NewReader(body))
if err != nil {
log.Fatal(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("DISRUPT_KEY"))
req.Header.Set("Content-Type", "application/json")
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/watchlists")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch("DISRUPT_KEY")}"
req["Content-Type"] = "application/json"
req.body = <<~JSON
{
"name": "Winter departures",
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z"
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40
}
]
}
JSON
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
$payload = <<<'JSON'
{
"name": "Winter departures",
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z"
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40
}
]
}
JSON;
$ch = curl_init("https://app.disruptapi.com/v1/watchlists");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("DISRUPT_KEY"),
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => $payload,
]);
$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 {
String body = """
{
"name": "Winter departures",
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z"
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40
}
]
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://app.disruptapi.com/v1/watchlists"))
.timeout(Duration.ofSeconds(30))
.header("Authorization", "Bearer " + System.getenv("DISRUPT_KEY"))
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.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"));
var body = """
{
"name": "Winter departures",
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z"
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40
}
]
}
""";
using var content = new StringContent(body, Encoding.UTF8, "application/json");
using var response = await http.PostAsync("https://app.disruptapi.com/v1/watchlists", content);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());{
"data": {
"id": "wl_3f9a1c2b7d4e5f60",
"org_id": "org_5c1f0a9e2b7d4c31",
"name": "Winter departures",
"description": null,
"created_at": "2026-11-18T08:02:11Z",
"items_stored": 2
}
}To add or change items later, post them to /v1/watchlists/{id}/items. Sending an existing id replaces that item. Flights and trips are dropped a day after they end.
4. Check exposure#
Ask which active disruptions touch your items, and why. You can check a saved watchlist with GET /v1/watchlists/{id}/exposure, or send items directly, without saving them:
curl -X POST "https://app.disruptapi.com/v1/exposure/check" \
-H "Authorization: Bearer $DISRUPT_KEY" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z"
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40
},
{ "id": "checkout", "kind": "provider", "provider": "cloudflare" }
],
"min_severity": "moderate"
}'// Node.js 18+ (built-in fetch), saved as an .mjs file
const res = await fetch("https://app.disruptapi.com/v1/exposure/check", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.DISRUPT_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
items: [
{
id: "BKG-7QX2LM",
kind: "flight",
carrier: "AS",
origin: "SEA",
destination: "HNL",
depart_at: "2026-11-21T08:00:00Z",
},
{
id: "HTL-ALCUDIA",
kind: "place",
label: "Hotel Alcudia",
lat: 39.85,
lon: 3.12,
radius_km: 40,
},
{ id: "checkout", kind: "provider", provider: "cloudflare" },
],
min_severity: "moderate",
}),
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.post(
"https://app.disruptapi.com/v1/exposure/check",
headers={"Authorization": f"Bearer {os.environ['DISRUPT_KEY']}"},
json={
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z",
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40,
},
{"id": "checkout", "kind": "provider", "provider": "cloudflare"},
],
"min_severity": "moderate",
},
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.post(
"/v1/exposure/check",
json={
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z",
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40,
},
{"id": "checkout", "kind": "provider", "provider": "cloudflare"},
],
"min_severity": "moderate",
},
)
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 (
"bytes"
"fmt"
"io"
"log"
"net/http"
"os"
"time"
)
func main() {
body := []byte(`{
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z"
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40
},
{ "id": "checkout", "kind": "provider", "provider": "cloudflare" }
],
"min_severity": "moderate"
}`)
req, err := http.NewRequest(http.MethodPost, "https://app.disruptapi.com/v1/exposure/check", bytes.NewReader(body))
if err != nil {
log.Fatal(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("DISRUPT_KEY"))
req.Header.Set("Content-Type", "application/json")
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/exposure/check")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch("DISRUPT_KEY")}"
req["Content-Type"] = "application/json"
req.body = <<~JSON
{
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z"
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40
},
{ "id": "checkout", "kind": "provider", "provider": "cloudflare" }
],
"min_severity": "moderate"
}
JSON
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
$payload = <<<'JSON'
{
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z"
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40
},
{ "id": "checkout", "kind": "provider", "provider": "cloudflare" }
],
"min_severity": "moderate"
}
JSON;
$ch = curl_init("https://app.disruptapi.com/v1/exposure/check");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("DISRUPT_KEY"),
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => $payload,
]);
$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 {
String body = """
{
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z"
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40
},
{ "id": "checkout", "kind": "provider", "provider": "cloudflare" }
],
"min_severity": "moderate"
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://app.disruptapi.com/v1/exposure/check"))
.timeout(Duration.ofSeconds(30))
.header("Authorization", "Bearer " + System.getenv("DISRUPT_KEY"))
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.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"));
var body = """
{
"items": [
{
"id": "BKG-7QX2LM",
"kind": "flight",
"carrier": "AS",
"origin": "SEA",
"destination": "HNL",
"depart_at": "2026-11-21T08:00:00Z"
},
{
"id": "HTL-ALCUDIA",
"kind": "place",
"label": "Hotel Alcudia",
"lat": 39.85,
"lon": 3.12,
"radius_km": 40
},
{ "id": "checkout", "kind": "provider", "provider": "cloudflare" }
],
"min_severity": "moderate"
}
""";
using var content = new StringContent(body, Encoding.UTF8, "application/json");
using var response = await http.PostAsync("https://app.disruptapi.com/v1/exposure/check", content);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());{
"data": [
{
"item_id": "BKG-7QX2LM",
"trip_id": "BKG-7QX2LM",
"kind": "flight",
"risk_level": "high",
"match_count": 1,
"matches": [
{
"signal": {
"id": "faa_ground_stop_SEA.k3j9x2m1qa",
"type": "aviation",
"subtype": "ground_stop",
"provider": "faa",
"failure_layer": null,
"failure_layer_label": null,
"title": "Ground Stop Program at SEA: low ceilings",
"severity": "severe",
"status": "active",
"countries": ["US"],
"airports": ["SEA"],
"areas": [],
"location": { "lat": 47.449, "lon": -122.309 },
"starts_at": null,
"ends_at": null,
"first_seen_at": "2026-11-18T06:52:10Z",
"updated_at": "2026-11-18T07:20:41Z",
"version": 2,
"source": {
"url": "https://nasstatus.faa.gov/",
"attribution": "FAA NAS Status",
"last_checked_at": "2026-11-18T07:21:02Z",
"stale": false
},
"details": { "reason": "low ceilings" }
},
"reasons": ["affects SEA"],
"risk_contribution": "high",
"forecast": null
}
]
},
{
"item_id": "HTL-ALCUDIA",
"trip_id": "HTL-ALCUDIA",
"kind": "place",
"risk_level": "none",
"match_count": 0,
"matches": []
},
{
"item_id": "checkout",
"trip_id": "checkout",
"kind": "provider",
"risk_level": "none",
"match_count": 0,
"matches": []
}
]
}There is one result per item, in the order you sent them. risk_level is the highest risk_contribution among its matches. See Watchlists and exposure for the matching rules.
5. Receive a webhook#
Register an HTTPS endpoint. With "watchlists": ["*"] it fires only when a signal touches one of your watched items, and the payload lists those items. Webhooks need a paid plan: Starter allows 3, Pro 20.
curl -X POST "https://app.disruptapi.com/v1/webhooks" \
-H "Authorization: Bearer $DISRUPT_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/webhooks/disrupt",
"filters": { "watchlists": ["*"], "min_severity": "moderate" }
}'// Node.js 18+ (built-in fetch), saved as an .mjs file
const res = await fetch("https://app.disruptapi.com/v1/webhooks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.DISRUPT_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
url: "https://example.com/webhooks/disrupt",
filters: { watchlists: ["*"], min_severity: "moderate" },
}),
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.post(
"https://app.disruptapi.com/v1/webhooks",
headers={"Authorization": f"Bearer {os.environ['DISRUPT_KEY']}"},
json={
"url": "https://example.com/webhooks/disrupt",
"filters": {"watchlists": ["*"], "min_severity": "moderate"},
},
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.post(
"/v1/webhooks",
json={
"url": "https://example.com/webhooks/disrupt",
"filters": {"watchlists": ["*"], "min_severity": "moderate"},
},
)
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 (
"bytes"
"fmt"
"io"
"log"
"net/http"
"os"
"time"
)
func main() {
body := []byte(`{
"url": "https://example.com/webhooks/disrupt",
"filters": { "watchlists": ["*"], "min_severity": "moderate" }
}`)
req, err := http.NewRequest(http.MethodPost, "https://app.disruptapi.com/v1/webhooks", bytes.NewReader(body))
if err != nil {
log.Fatal(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("DISRUPT_KEY"))
req.Header.Set("Content-Type", "application/json")
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/webhooks")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch("DISRUPT_KEY")}"
req["Content-Type"] = "application/json"
req.body = <<~JSON
{
"url": "https://example.com/webhooks/disrupt",
"filters": { "watchlists": ["*"], "min_severity": "moderate" }
}
JSON
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
$payload = <<<'JSON'
{
"url": "https://example.com/webhooks/disrupt",
"filters": { "watchlists": ["*"], "min_severity": "moderate" }
}
JSON;
$ch = curl_init("https://app.disruptapi.com/v1/webhooks");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("DISRUPT_KEY"),
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => $payload,
]);
$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 {
String body = """
{
"url": "https://example.com/webhooks/disrupt",
"filters": { "watchlists": ["*"], "min_severity": "moderate" }
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://app.disruptapi.com/v1/webhooks"))
.timeout(Duration.ofSeconds(30))
.header("Authorization", "Bearer " + System.getenv("DISRUPT_KEY"))
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.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"));
var body = """
{
"url": "https://example.com/webhooks/disrupt",
"filters": { "watchlists": ["*"], "min_severity": "moderate" }
}
""";
using var content = new StringContent(body, Encoding.UTF8, "application/json");
using var response = await http.PostAsync("https://app.disruptapi.com/v1/webhooks", content);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());{
"data": {
"id": "whk_8d2c41f0a6b9e357",
"org_id": "org_5c1f0a9e2b7d4c31",
"url": "https://example.com/webhooks/disrupt",
"secret": "whsec_3b9f0c...",
"filters": { "min_severity": "moderate", "watchlists": ["*"] },
"created_at": "2026-11-18T08:05:40Z"
}
}Verify each delivery before you trust it. Webhooks has the verification code in eight languages and explains retries.
What next?#
- Authentication: key rotation and security.
- Rate limits and quotas: what each plan allows and the headers to watch.
- Best practices: polling or webhooks, deduplication and retries.
- API reference: every endpoint.
Last updated 2026-11-18. Questions or a mistake on this page? Contact us.