Frequently asked questions
What DisruptAPI does, where the data comes from and how billing works. Missing something? Ask us.
What is DisruptAPI?
DisruptAPI is a travel disruption API. It collects ground stops and airport delays, severe weather warnings, wildfires and other natural hazards, government travel advisories, unrest and strikes, rocket launch closures, GPS interference, health notices and cloud outages from 93 official and open sources, matches them to the flights, trips, places, airlines and suppliers you care about, and forecasts the likely impact from what similar events did before.
What is a travel disruption API?
An API that reports events likely to delay, cancel or endanger travel, such as ground stops, weather warnings, travel advisories, strikes and IT outages, in one consistent format, so software can react automatically. DisruptAPI also matches each event to your own bookings and explains why it matched.
Who uses a travel disruption API?
Tour operators and DMCs, travel management companies, online travel agencies, travel insurers and assistance companies, event organisers, airlines, airports and ground handlers. They all need to act when travel goes wrong, before their customers or travellers ask.
Where does the data come from?
From official and open sources: the FAA, EASA, national weather services (through EUMETNET Meteoalarm and directly in the US, Canada and six more countries), NOAA, USGS, GDACS, the National Interagency Fire Center, foreign ministries in six countries, the CDC, Launch Library 2 for rocket launches, adsb.lol aircraft reports for GPS interference, the public status pages of cloud and SaaS providers, and GDELT news event data for unrest and conflict, which is labelled news-derived. DisruptAPI reads each source itself, links every signal back to it, and publishes the full list with licences at /v1/sources.
How is DisruptAPI different from a flight status API?
A flight status API tells you a flight is late once it is late. DisruptAPI tracks the causes (a ground stop, a red weather warning, an outage at the provider behind an airline's check-in) and tells you which of your bookings they are likely to hit, usually before the flight status changes. It does not report the status of individual flights.
What is an exposure check?
You send a list of items (flights, trips, places, carriers or providers) and DisruptAPI returns, for each one, the active disruptions that touch it, a reason in plain words, a risk level from none to severe, and a forecast where history allows.
How do the impact forecasts work?
For each kind of outcome, such as flight cancellations or check-in failures, DisruptAPI looks for past events of the same kind with at least five measured cases. It reports the probability with an 80% interval, the number of cases behind it and example events, and compares it with the same outcome in matched quiet weeks (the base rate). When an outcome is no more likely than in a normal week, the forecast says so. Thin evidence is flagged as low confidence.
How quickly does DisruptAPI pick up a new disruption?
FAA airport status and the main cloud status pages are polled every two minutes. Weather warnings, hazards and most other sources every five to fifteen minutes. A few slow-moving sources, such as aviation safety bulletins and some advisories, hourly.
Which countries are covered?
Signals are global: travel advisories, natural hazards, SIGMETs and cloud outages apply worldwide, and the airport reference covers 4,000+ airports in 234 countries and territories. Official weather warnings come from Meteoalarm in 38 European countries and from the national services of the US, Canada, Argentina, Colombia, the Philippines, New Zealand, Saudi Arabia and Taiwan, placed on the area they cover. Everywhere else, the live weather at 5,000 airports (from their METAR reports) shows fog, freezing rain, snow, storms and wind as they happen. Unrest and conflict signals cover every country. US airports also have measured cancellation history.
Can I try DisruptAPI for free?
Yes. Every new key starts on a sandbox with 100 requests a month and 5 watched items, with no card required. That is enough to check a few of your own bookings and read the reasons. Paid plans start at $99 a month.
How do webhooks work?
Register an https endpoint and choose what you want: signal types, minimum severity, countries, airports, or only signals that touch your watchlists. DisruptAPI sends a signed POST when a matching signal is created, escalates, changes or is resolved, and retries a failed delivery five times over about nine hours.
Can AI assistants and agents use DisruptAPI?
Yes. DisruptAPI runs a remote MCP (Model Context Protocol) server at /mcp that works with Claude, Cursor, VS Code and any agent that speaks MCP over Streamable HTTP. It has 14 tools, including exposure checks, live signals, airport and airline profiles, forecasts and watchlists, and it uses your normal API key, plan and limits.
Is there an API for FAA ground stops?
Yes. DisruptAPI polls FAA NAS status every two minutes and returns ground stops, ground delay programmes and airport closures as signals through GET /v1/signals?type=aviation, exposure checks and webhooks. FAA itself offers no developer API for this data.
Can I get travel advisories from several governments in one API?
Yes. DisruptAPI reads the advisories of the United States, the United Kingdom, Canada, Australia, Germany and the Netherlands and maps them to one five-step severity scale, with a link to each original.
Does DisruptAPI provide traveller tracking or 24/7 assistance?
No. DisruptAPI is a data API. You keep traveller data in your own systems and send the trips, flights or places you want checked. It does not locate people, run an operations centre or provide assistance.
Where do strike and unrest signals come from?
From GDELT news event data. A signal needs reports from several independent outlets, and every one is labelled news-derived so you can treat it differently from an official warning.
Is DisruptAPI GDPR friendly?
DisruptAPI matches on airports, coordinates, countries and dates. You choose the item ids and labels, so you can use opaque references and keep personal data in your own systems. A Data Processing Addendum with Standard Contractual Clauses is part of the terms; see /dpa/.
Hear about the disruption before your customers do
Create a key, add the flights, trips and places you want watched, and get a signed webhook whenever a disruption touches one. Try it on a sandbox key first, no card needed.