API reference

Every endpoint of the DisruptAPI v1 REST API, with its parameters, a request in eight languages, a response and the errors it can return. Base URL https://app.disruptapi.com; authenticate with Authorization: Bearer dk_live_....

The machine-readable spec is /openapi.json (OpenAPI 3.1), with an interactive version at /docs on the API host. Response values below are illustrative; shapes and field names are exact. Long arrays are cut to "...".

Endpoints#

MethodPathWhat it does
GET/v1/plansList plans
GET/v1/meGet the current key
GET/v1/usageGet usage
GET/v1/signalsList signals
GET/v1/signals/{signal_id}Get a signal
POST/v1/exposure/checkCheck exposure
GET/v1/watchlistsList watchlists
POST/v1/watchlistsCreate a watchlist
GET/v1/watchlists/{wl_id}Get a watchlist
DELETE/v1/watchlists/{wl_id}Delete a watchlist
POST/v1/watchlists/{wl_id}/itemsAdd or update items
DELETE/v1/watchlists/{wl_id}/items/{ref}Remove an item
GET/v1/watchlists/{wl_id}/exposureGet watchlist exposure
GET/v1/forecastForecast an IT outage
GET/v1/failure-layersList failure layers
GET/v1/eventsList past events
GET/v1/events/{event_id}Get a past event
GET/v1/airports/{iata}Get an airport profile
GET/v1/carriers/{code}Get an airline profile
GET/v1/providersList watched providers
GET/v1/sourcesList sources
GET/v1/webhooksList webhooks
POST/v1/webhooksCreate a webhook
DELETE/v1/webhooks/{hook_id}Delete a webhook

Account#

Your plan, key and usage.

List plans#

GET/v1/plansno key needed

All plans with their limits. No key needed and not counted against any limit.

Request
curl "https://app.disruptapi.com/v1/plans" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": [
    {
      "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
    },
    {
      "id": "starter",
      "name": "Starter",
      "price_usd_month": 99,
      "monthly_requests": 50000,
      "per_minute": 60,
      "webhooks": 3,
      "exposure_check": true,
      "description": "Exposure checks, impact forecasts, 2,500 watched items and 3 webhooks.",
      "watch_items": 2500
    },
    "..."
  ]
}

Get the current key#

GET/v1/me

The organisation, plan and key behind the request, and requests used this month.

Request
curl "https://app.disruptapi.com/v1/me" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": {
    "org": {
      "id": "org_5c1f0a9e2b7d4c31",
      "name": "Acme Travel",
      "plan": {
        "id": "starter",
        "name": "Starter",
        "price_usd_month": 99,
        "monthly_requests": 50000,
        "per_minute": 60,
        "webhooks": 3,
        "exposure_check": true,
        "description": "Exposure checks, impact forecasts, 2,500 watched items and 3 webhooks.",
        "watch_items": 2500
      }
    },
    "key": { "id": "key_9a0e47c2d1b3f856", "name": "booking-api-prod" },
    "requests_this_month": 1834
  }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded

Get usage#

GET/v1/usage

Requests per day, by route and by key. MCP tool calls appear under the tool name.

Parameters

NameInTypeDescription
daysqueryintegerDays of daily history, 1 to 365. Default: 30.
Request
curl "https://app.disruptapi.com/v1/usage?days=7" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": {
    "month": "2026-11",
    "requests_this_month": 1834,
    "daily": [
      {
        "day": "2026-11-17",
        "requests": 212,
        "errors": 3,
        "avg_latency_ms": 84
      }
    ],
    "by_route_this_month": [
      { "route": "/v1/exposure/check", "requests": 1210 },
      { "route": "check_exposure", "requests": 40 }
    ],
    "by_key_this_month": [
      {
        "id": "key_9a0e47c2d1b3f856",
        "name": "booking-api-prod",
        "prefix": "dk_live_Ab3xY9",
        "requests": 1790
      }
    ],
    "plan": {
      "id": "starter",
      "name": "Starter",
      "price_usd_month": 99,
      "monthly_requests": 50000,
      "per_minute": 60,
      "webhooks": 3,
      "exposure_check": true,
      "description": "Exposure checks, impact forecasts, 2,500 watched items and 3 webhooks.",
      "watch_items": 2500
    }
  }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, invalid_request

Signals#

Live and resolved disruptions. See Signals for every field.

List signals#

GET/v1/signals

Signals matching the filters, most severe first, then most recently updated. Records returned count against the daily record budget.

Parameters

NameInTypeDescription
statusquerystringactive, resolved or all. Default: active.
typequerystringComma-separated types: it_outage, aviation, weather, natural_hazard, security, internet, health, labor, infrastructure.
min_severityquerystringminor, moderate, severe or extreme. Signals below it are ignored.
countryquerystringISO 3166-1 alpha-2, exactly 2 characters.
airportquerystringIATA code, exactly 3 characters.
providerquerystringProvider id, e.g. aws, cloudflare, faa.
sincequerystringOnly signals updated at or after this UTC time, as 2026-11-18T06:00:00Z. See since.
limitqueryinteger1 to 500, and at most the plan page size (Sandbox 50, Starter 200). Default: 50.
offsetqueryintegerResults to skip. Default: 0.
Request
curl "https://app.disruptapi.com/v1/signals?type=aviation,weather&min_severity=severe&country=US&limit=20" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "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": 1, "limit": 20, "offset": 0 }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, invalid_request, limit_too_large, daily_data_limit

Get a signal#

GET/v1/signals/{signal_id}

One signal, active or resolved, with impact_forecast. For IT outages the forecast is built from analogs; for other types it has recommended actions and airport base rates. See Forecasts.

Parameters

NameInTypeDescription
signal_idrequiredpathstringA signal id as returned to your key, including its suffix.
Request
curl "https://app.disruptapi.com/v1/signals/sp_cloudflare_9x2kd81mzq3r.p2c7d0w5ha" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": {
    "id": "sp_cloudflare_9x2kd81mzq3r.p2c7d0w5ha",
    "type": "it_outage",
    "subtype": "provider_incident",
    "provider": "cloudflare",
    "failure_layer": "edge_cdn_dns",
    "failure_layer_label": "Edge, CDN and DNS",
    "title": "Elevated errors for requests through our network",
    "severity": "severe",
    "status": "active",
    "countries": [],
    "airports": [],
    "areas": [],
    "location": null,
    "starts_at": "2026-11-18T09:12:00Z",
    "ends_at": null,
    "first_seen_at": "2026-11-18T09:14:33Z",
    "updated_at": "2026-11-18T09:40:05Z",
    "version": 3,
    "source": {
      "url": "https://stspg.io/example",
      "attribution": "Cloudflare status page",
      "last_checked_at": "2026-11-18T09:41:00Z",
      "stale": false
    },
    "details": {
      "components": ["CDN/Cache", "DNS"],
      "provider_status": "identified"
    },
    "impact_forecast": {
      "basis": "analogs",
      "failure_layer": "edge_cdn_dns",
      "failure_layer_label": "Edge, CDN and DNS",
      "analog_count": 14,
      "analogs": ["..."],
      "outcomes": ["..."],
      "expected_duration_hours": {
        "p50": 2.4,
        "p90": 7.9,
        "n": 11,
        "analog_level": "same failure layer, any provider"
      },
      "carriers_at_elevated_risk": ["..."],
      "contrast": "...",
      "recommended_actions": ["..."],
      "notes": ["..."]
    }
  }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, not_found

Exposure#

Match your items to active signals. See Watchlists and exposure for the matching rules.

Check exposure#

POST/v1/exposure/check

For each item, the active signals that touch it, the reasons, a risk level and, for IT outages, a short forecast. One result per item, in request order.

Request body

FieldTypeDescription
itemsrequiredItem[]Up to 500 items. See item fields. At least one item in items or trips.
tripsItem[]Older name for items, still accepted; up to 500. Combined with items.
min_severitystringIgnore signals below this severity. Default: moderate.
Request
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"
}'
Response (200)JSON
{
  "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
        }
      ]
    },
    "..."
  ]
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, invalid_request, plan_required, payload_too_large

Watchlists#

Saved items that are matched against every new signal. Items are keyed by your own id.

List watchlists#

GET/v1/watchlists

Your watchlists with their live item counts, and your plan's item limit (-1 means unlimited).

Request
curl "https://app.disruptapi.com/v1/watchlists" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": [
    {
      "id": "wl_3f9a1c2b7d4e5f60",
      "org_id": "org_5c1f0a9e2b7d4c31",
      "name": "Winter departures",
      "description": "Bookings departing Dec to Feb",
      "created_at": "2026-11-18T08:02:11Z",
      "deleted_at": null,
      "items": 2
    }
  ],
  "limits": { "watch_items": 2500, "used": 2 }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded

Create a watchlist#

POST/v1/watchlists

Creates a watchlist, optionally with its first items. If the items are refused, the watchlist is not kept.

Request body

FieldTypeDescription
namerequiredstring1 to 100 characters.
descriptionstringAt most 500 characters.
itemsItem[]Up to 1,000 items, each with an id.
Request
curl -X POST "https://app.disruptapi.com/v1/watchlists" \
  -H "Authorization: Bearer $DISRUPT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Winter departures",
  "description": "Bookings departing Dec to Feb",
  "items": [
    {
      "id": "BKG-7QX2LM",
      "kind": "flight",
      "carrier": "AS",
      "origin": "SEA",
      "destination": "HNL",
      "depart_at": "2026-11-21T08:00:00Z"
    }
  ]
}'
Response (201)JSON
{
  "data": {
    "id": "wl_3f9a1c2b7d4e5f60",
    "org_id": "org_5c1f0a9e2b7d4c31",
    "name": "Winter departures",
    "description": "Bookings departing Dec to Feb",
    "created_at": "2026-11-18T08:02:11Z",
    "items_stored": 1
  }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, invalid_request, invalid_items

Get a watchlist#

GET/v1/watchlists/{wl_id}

A watchlist and its live items as you sent them, including your own extra fields, newest first.

Parameters

NameInTypeDescription
wl_idrequiredpathstringWatchlist id, wl_....
limitqueryintegerItems to return, 1 to 1,000. Default: 100.
Request
curl "https://app.disruptapi.com/v1/watchlists/wl_3f9a1c2b7d4e5f60?limit=100" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": {
    "id": "wl_3f9a1c2b7d4e5f60",
    "org_id": "org_5c1f0a9e2b7d4c31",
    "name": "Winter departures",
    "description": "Bookings departing Dec to Feb",
    "created_at": "2026-11-18T08:02:11Z",
    "deleted_at": null,
    "items": [
      {
        "id": "BKG-7QX2LM",
        "kind": "flight",
        "carrier": "AS",
        "origin": "SEA",
        "destination": "HNL",
        "depart_at": "2026-11-21T08:00:00Z"
      }
    ]
  }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, not_found

Delete a watchlist#

DELETE/v1/watchlists/{wl_id}

Deletes the watchlist and all its items. Webhooks filtered on this watchlist id stop matching it.

Parameters

NameInTypeDescription
wl_idrequiredpathstringWatchlist id, wl_....
Request
curl -X DELETE "https://app.disruptapi.com/v1/watchlists/wl_3f9a1c2b7d4e5f60" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{ "data": { "id": "wl_3f9a1c2b7d4e5f60", "deleted": true } }

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, not_found

Add or update items#

POST/v1/watchlists/{wl_id}/items

Stores items, replacing any with the same id. new counts ids that were not on this watchlist before. Fails as a whole if it would exceed your plan's item limit.

Parameters

NameInTypeDescription
wl_idrequiredpathstringWatchlist id, wl_....

Request body

FieldTypeDescription
itemsrequiredItem[]Items to store, see item fields. Every item needs an id. 1 to 1,000 per call.
Request
curl -X POST "https://app.disruptapi.com/v1/watchlists/wl_3f9a1c2b7d4e5f60/items" \
  -H "Authorization: Bearer $DISRUPT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    {
      "id": "HTL-ALCUDIA",
      "kind": "place",
      "label": "Hotel Alcudia",
      "lat": 39.85,
      "lon": 3.12,
      "radius_km": 40,
      "starts_at": "2026-12-03T14:00:00Z",
      "ends_at": "2026-12-07T11:00:00Z"
    }
  ]
}'
Response (200)JSON
{ "data": { "stored": 1, "new": 1 } }

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, not_found, invalid_request, invalid_items, payload_too_large

Remove an item#

DELETE/v1/watchlists/{wl_id}/items/{ref}

Removes one item by your id. URL-encode ids that contain / or other reserved characters.

Parameters

NameInTypeDescription
wl_idrequiredpathstringWatchlist id, wl_....
refrequiredpathstringThe item's id.
Request
curl -X DELETE "https://app.disruptapi.com/v1/watchlists/wl_3f9a1c2b7d4e5f60/items/BKG-7QX2LM" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{ "data": { "id": "BKG-7QX2LM", "deleted": true } }

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, not_found

Get watchlist exposure#

GET/v1/watchlists/{wl_id}/exposure

Only the items on this watchlist that active signals touch right now, in the exposure result shape plus watchlist_id.

Parameters

NameInTypeDescription
wl_idrequiredpathstringWatchlist id, wl_....
min_severityquerystringminor, moderate, severe or extreme. Signals below it are ignored. Default: moderate.
Request
curl "https://app.disruptapi.com/v1/watchlists/wl_3f9a1c2b7d4e5f60/exposure?min_severity=moderate" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "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
        }
      ],
      "watchlist_id": "wl_3f9a1c2b7d4e5f60"
    }
  ]
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, not_found, plan_required

Forecasts and history#

What comparable past events did. See Forecasts.

Forecast an IT outage#

GET/v1/forecast

What history says an outage of this provider and failure layer does to travel. The response has the forecast fields.

Parameters

NameInTypeDescription
failure_layerrequiredquerystringAn id from GET /v1/failure-layers.
providerquerystringe.g. aws, azure, gcp, cloudflare. Without it, the forecast uses the layer and broader groups.
Request
curl "https://app.disruptapi.com/v1/forecast?provider=azure&failure_layer=identity" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": {
    "basis": "analogs",
    "failure_layer": "identity",
    "failure_layer_label": "Identity and sign-in",
    "analog_count": 9,
    "analogs": ["..."],
    "outcomes": ["..."],
    "expected_duration_hours": {
      "p50": 3.1,
      "p90": 9.4,
      "n": 9,
      "analog_level": "same failure layer, any provider"
    },
    "carriers_at_elevated_risk": ["..."],
    "contrast": "...",
    "recommended_actions": [
      "Staff sign-in to airline and agency tools may fail; expect slower service desks"
    ],
    "notes": ["..."]
  }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, invalid_failure_layer, invalid_request

List failure layers#

GET/v1/failure-layers

Every failure layer id and label, for GET /v1/forecast and the failure_layer of provider items.

Request
curl "https://app.disruptapi.com/v1/failure-layers" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": [
    {
      "id": "endpoint_agent_or_os",
      "label": "Endpoint agent or operating system"
    },
    { "id": "edge_cdn_dns", "label": "Edge, CDN and DNS" },
    {
      "id": "cloud_region",
      "label": "Cloud region (compute, databases)"
    },
    { "id": "identity", "label": "Identity and sign-in" },
    "..."
  ]
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded

List past events#

GET/v1/events

The catalogue of past disruptions that forecasts learn from, with their measured or documented outcomes. Landmark events first, then newest first. Records returned count against the daily record budget.

Parameters

NameInTypeDescription
providerquerystringExact provider id.
failure_layerquerystringA failure layer id.
anchor_onlyquerybooleanOnly landmark events. Default: false.
limitqueryinteger1 to 500, and at most the plan page size. Default: 50.
offsetqueryintegerResults to skip. Default: 0.
Request
curl "https://app.disruptapi.com/v1/events?failure_layer=endpoint_agent_or_os&anchor_only=true" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": [
    {
      "id": "2024-07-crowdstrike",
      "source": "anchor",
      "type": "it_outage",
      "provider": "crowdstrike",
      "failure_layer": "endpoint_agent_or_os",
      "title": "CrowdStrike faulty update crashes Windows machines",
      "starts_at": "2024-07-19T04:09:00Z",
      "ends_at": null,
      "duration_h": null,
      "url": null,
      "regions": ["GLOBAL"],
      "is_anchor": true,
      "outcomes": [
        {
          "outcome": "any_cancellations",
          "happened": true,
          "basis": "documented"
        },
        {
          "outcome": "checkin_disrupted",
          "happened": true,
          "basis": "documented"
        },
        {
          "outcome": "website_or_app_down",
          "happened": true,
          "basis": "documented"
        }
      ],
      "carriers_affected": [
        { "carrier": "DL", "basis": "documented" },
        { "carrier": "UA", "basis": "documented" },
        "..."
      ]
    }
  ],
  "meta": { "total": 1, "limit": 50, "offset": 0 }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, invalid_request, limit_too_large, daily_data_limit

Get a past event#

GET/v1/events/{event_id}

One past event. Each outcome also has detail, the measurement or source behind it.

Parameters

NameInTypeDescription
event_idrequiredpathstringEvent id from GET /v1/events.
Request
curl "https://app.disruptapi.com/v1/events/2024-07-crowdstrike" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": {
    "id": "2024-07-crowdstrike",
    "source": "anchor",
    "type": "it_outage",
    "provider": "crowdstrike",
    "failure_layer": "endpoint_agent_or_os",
    "title": "CrowdStrike faulty update crashes Windows machines",
    "starts_at": "2024-07-19T04:09:00Z",
    "ends_at": null,
    "duration_h": null,
    "url": null,
    "regions": ["GLOBAL"],
    "is_anchor": true,
    "outcomes": [
      {
        "outcome": "any_cancellations",
        "happened": true,
        "basis": "documented",
        "detail": "..."
      }
    ],
    "carriers_affected": [
      { "carrier": "DL", "basis": "documented" },
      { "carrier": "UA", "basis": "documented" },
      "..."
    ]
  }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, not_found

Reference data#

Profiles of airports, airlines and providers, and the source register.

Get an airport profile#

GET/v1/airports/{iata}

Active signals at the airport (up to 100), country-wide weather, security and internet signals of moderate or higher that do not list it (up to 30), monthly cancellation and delay base rates where measured (US airports), and the providers its website depends on. Signals returned count against the daily record budget.

Parameters

NameInTypeDescription
iatarequiredpathstringIATA airport code, any case.
Request
curl "https://app.disruptapi.com/v1/airports/SEA" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": {
    "airport": {
      "iata": "SEA",
      "icao": "KSEA",
      "name": "Seattle-Tacoma International Airport",
      "city": "Seattle",
      "country": "US",
      "lat": 47.449,
      "lon": -122.309,
      "size": "large_airport"
    },
    "active_signals": [
      {
        "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" }
      }
    ],
    "country_signals": [],
    "base_rates_by_month": [
      {
        "month": 11,
        "days_measured": 90,
        "flights": 41230,
        "cancel_rate_pct": 0.92,
        "p90_daily_cancel_rate_pct": 2.1,
        "delayed_15_rate_pct": 17.4,
        "weather_share_of_cancellations_pct": 38.5,
        "period": ["2023-11-01", "2025-11-30"]
      }
    ],
    "website_dependencies": [
      {
        "provider": "cloudflare",
        "layer": "edge_cdn",
        "confidence": "high"
      }
    ]
  }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, not_found, daily_data_limit

Get an airline profile#

GET/v1/carriers/{code}

What the airline's public systems run on, active IT outages that put it at risk, and up to 50 past events that hit it. Returns 404 when there is no data for the code yet. Records returned count against the daily record budget.

Parameters

NameInTypeDescription
coderequiredpathstringIATA airline code, any case.
Request
curl "https://app.disruptapi.com/v1/carriers/AA" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": {
    "carrier": "AA",
    "domain": "aa.com",
    "dependencies": [
      {
        "provider": "akamai",
        "layer": "dns",
        "confidence": "high",
        "seen_at": "2026-11-14T18:24:34Z"
      },
      {
        "provider": "microsoft_365",
        "layer": "email",
        "confidence": "high",
        "seen_at": "2026-11-14T18:24:34Z"
      }
    ],
    "providers": ["akamai", "microsoft_365"],
    "active_it_outages_affecting": [],
    "past_events": [
      {
        "id": "2024-07-crowdstrike",
        "title": "CrowdStrike faulty update crashes Windows machines",
        "starts_at": "2024-07-19T04:09:00Z",
        "failure_layer": "endpoint_agent_or_os",
        "provider": "crowdstrike",
        "basis": "documented"
      }
    ]
  }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, not_found, daily_data_limit

List watched providers#

GET/v1/providers

The cloud and SaaS providers DisruptAPI watches, and whether each has an active incident now.

Request
curl "https://app.disruptapi.com/v1/providers" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": [
    {
      "provider": "akamai",
      "status": "operational",
      "active_incidents": 0,
      "worst_severity": null
    },
    {
      "provider": "cloudflare",
      "status": "incident",
      "active_incidents": 1,
      "worst_severity": "severe"
    },
    "..."
  ]
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded

List sources#

GET/v1/sources

The source register: each upstream source with its publisher, coverage, licence, the attribution to show, how often it is checked and whether it is fresh now. status is ok, degraded (some feeds stale) or stale. licence.commercial_use is public_domain, open_licence, facts_only or under_review.

Request
curl "https://app.disruptapi.com/v1/sources" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": [
    {
      "id": "faa_nas_status",
      "name": "FAA National Airspace System Status",
      "publisher": "US Federal Aviation Administration",
      "signal_types": ["aviation"],
      "coverage": "US airports: ground stops, ground delay programmes, closures, delays",
      "licence": {
        "name": "US public domain",
        "url": null,
        "commercial_use": "public_domain"
      },
      "attribution": "US Federal Aviation Administration",
      "feeds": 1,
      "checked_every_s": 120,
      "last_checked_at": "2026-11-18T07:21:02Z",
      "stale_feeds": 0,
      "status": "ok"
    },
    "..."
  ]
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded

Webhooks#

Signed push notifications. See Webhooks for payloads, signatures and retries.

List webhooks#

GET/v1/webhooks

All your webhooks, newest first, including disabled ones. The secret is cut to its first 10 characters.

Request
curl "https://app.disruptapi.com/v1/webhooks" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{
  "data": [
    {
      "id": "whk_8d2c41f0a6b9e357",
      "org_id": "org_5c1f0a9e2b7d4c31",
      "url": "https://example.com/webhooks/disrupt",
      "secret": "whsec_3b9f…",
      "filters": { "min_severity": "moderate", "watchlists": ["*"] },
      "created_at": "2026-11-18T08:05:40Z",
      "disabled_at": null,
      "failures": 0
    }
  ]
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded

Create a webhook#

POST/v1/webhooks

Registers an endpoint. The response holds the full signing secret, once. Filters are stored normalised: codes upper-cased, lists sorted and deduplicated.

Request body

FieldTypeDescription
urlrequiredstringPublic https URL on port 443 or 8443, at most 500 characters.
filtersobjecttypes, min_severity, countries, airports, carriers, events, watchlists. See filters.
Request
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" }
}'
Response (201)JSON
{
  "data": {
    "id": "whk_8d2c41f0a6b9e357",
    "org_id": "org_5c1f0a9e2b7d4c31",
    "url": "https://example.com/webhooks/disrupt",
    "secret": "whsec_3b9f0c5e1a7d2846f0b3c9e1a5d7f2b4c6e8a0d1f3b5c7e9",
    "filters": { "min_severity": "moderate", "watchlists": ["*"] },
    "created_at": "2026-11-18T08:05:40Z"
  }
}

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, invalid_request, invalid_webhook

Delete a webhook#

DELETE/v1/webhooks/{hook_id}

Disables the webhook at once. It stays in the list with disabled_at set. Returns 404 if it is already disabled.

Parameters

NameInTypeDescription
hook_idrequiredpathstringWebhook id, whk_....
Request
curl -X DELETE "https://app.disruptapi.com/v1/webhooks/whk_8d2c41f0a6b9e357" \
  -H "Authorization: Bearer $DISRUPT_KEY"
Response (200)JSON
{ "data": { "id": "whk_8d2c41f0a6b9e357", "deleted": true } }

Errors: missing_api_key, invalid_api_key, rate_limited, quota_exceeded, not_found

Public endpoints#

These two need no key. Each IP address can call them 20 times a minute; over that they return 429 rate_limited with Retry-After: 60.

GET/v1/public/statusno key needed

A coarse summary for status pages: counts of active signals by type, up to 12 headline signals without ids, and map points snapped to a 1.5 degree grid. Cached for 60 seconds. Not a data feed.

GET/v1/public/gnss-interferenceno key needed

The GPS interference cell table, open under ODbL 1.0: per 2-degree cell counts only, with the method and attribution.

cURL
curl https://app.disruptapi.com/v1/public/gnss-interference

MCP endpoint#

POST/mcp

JSON-RPC 2.0 over MCP Streamable HTTP, with the same key. See MCP server.

Last updated 2026-11-18. Questions or a mistake on this page? Contact us.