How It Works - NES Outage Status Checker

Where Does This Data Come From?

All data displayed on this site comes directly from Nashville Electric Service (NES). We don't add, modify, or interpret any of the information - we simply fetch it from NES's public API and display it in a more accessible format.

This tool is essentially a "viewer" for NES's own outage data. The Assigned/Unassigned status, affected customer counts, cause descriptions, and all other fields are provided by NES - not by us.

The NES API

NES provides a public API endpoint that returns all active outage events as JSON data:

https://utilisocial.io/datacapable/v2/p/NES/map/events

This is the same data source that powers NES's official outage map. We just fetch it and present it differently.

What Each Event Looks Like

Here's an example of what NES returns for a single outage event:

{ "id": 123456, "title": "Outage", "status": "Unassigned", "numPeople": 847, "cause": "Under Investigation", "startTime": 1706540400000, "lastUpdatedTime": 1706541300000, "latitude": 36.1627, "longitude": -86.7816 }

The Status Field

The status field is provided directly by NES and typically has one of these values:

NES returns:

"Unassigned"

No crew has been dispatched yet

NES returns:

"Assigned"

A crew is on the way or working on it

We display these exactly as NES provides them. When you see "UNASSIGNED" in red or "ASSIGNED" in green, that's coming straight from NES's system - we're just making it more visible.

Why Build This?

NES already has an outage map, but this tool provides some additional features:

Monitor specific events - Track your outage by Event ID
Browser notifications - Get alerted when status changes
See all outages at once - Filter and sort by status, duration, or impact
Shareable links - Send someone a link to monitor the same events
Map visualization - See geographic distribution of assigned vs unassigned outages

Open Source

This project is completely open source. You can view all the code, see exactly how data is fetched and displayed, and even run your own copy:

github.com/NeckBeardPrince/nes-outage-status-checker