APIs

IODA's APIs allow users to query for outages detected by IODA. IODA detects outages using three data sources—Internet Background Radiation (IBR), BGP, and active probing. For more information about the detection methodology see the Help page.

IODA has been monitoring and detecting Internet outages since July 2014. IODA's APIs have been designed to allow users to query for subsets of outages that they are interested in. We currently offer two APIs to access these outages.

Event API

The Event API allows querying for outage events detected by IODA. An outage event is an instance of a macroscopic Internet outage affecting the edge of the network. Each event has well-defined fields, such as the outage's start-time, duration and other fields, as defined in the Common Outage Data Format. Events are detected by IODA when there is a significant drop followed by a subsequent increase in the timeseries of an IODA data source for a group of addresses (such as addresses belonging to the same geographic region or Autonomous System).

Alert API

The Alert API allows querying IODA's outage alerts. An outage alert signifies the beginning or end of a potential outage event. However, unlike events, alerts have no duration and are instead generated by IODA when there is a significant drop (or subsequent increase) in the timeseries of an IODA data source for a group of addresses (such as addresses belonging to the same geographic region or Autonomous System). IODA's help page contains more details on how IODA generates alerts for each of its data sources.

Event API vs. Alert API

Most users' use-cases will be addressed by the event API since this API returns outage data that has been processed to remove some sources of noise from the underlying alerts that IODA generates. However, the event API itself internally uses the alert API.