MassOutage API

A free, open-CORS JSON API. All responses are wrapped in { "data": ... }. Counties are addressed by their 5-digit FIPS code (Harris County, TX = 48201).

GET /api/v1/live/summary

National + per-state live outage totals.

GET /api/v1/live/map

Compact { fips: customers_out } for every county currently out.

GET /api/v1/live/top

Ranked live leaders — states, counties, providers.

GET /api/v1/live/timeline?hours=24

State-level severity timeline (frames) behind the 24h map animation.

GET /api/v1/live/counties/48201

Live status for one county (by 5-digit FIPS).

GET /api/v1/counties/48201

County metadata + live + yearly history.

GET /api/v1/counties/48201/history

Monthly series + worst recorded events.

GET /api/v1/counties/48201/chart/decade

Branded PNG chart (also: /monthly, /live) — download or hotlink.

GET /api/v1/reports/2024/chart

Branded PNG of a report's decade trend (also /reports/2024/{state}/chart).

Newsrooms: grab auto-updating branded chart embeds and downloadable images on the newsrooms page.

See also /llms.txt for a machine-readable overview. Please cite MassOutage and link back when using this data.