Power Outages By County

About This Endpoint

This API endpoint will show power outages by the selected utility in snapshots of the given interval for the given period of time. This data is limited to outages in your coverage area as defined on your App Settings page.

Using the Query Builder

With the Query Builder, you can specify the parameters for your request such as the utility for which you wish to receive data, the length of time for which to retrieve power outage data, and the interval at which to see snapshots of power outages during that time range. You can also select the output format of your request.

As you modify the request parameters, your URL to use will update automatically. Click the Copy button next to the URL to copy it to your clipboard, and paste it into your script or browser to download the results. The generated URL will automatically include your account's API key.

• Tip: Outage data shown by this API endpoint will be filtered by your coverage area as defined on your App Settings page before querying the database. Be sure your defined coverage area is accurate before using this endpoint.

Do It Yourself

The /poweroutages/by-utility endpoint accepts the following query parameters:

• utilities
  • (Required) The database ID of the utility company for which to retrieve power outage data.
• history
  • (Required) An integer or floating point value representing the number of hours for which to retrieve historical data.
• interval
  • (Required) An integer value representing the number of minutes within the given time range to snapshot outage data. This value should be equally divisible into the time range and greater than 10 (our power outage data does not have granularity of less than 10 minutes).
• format
  • (Optional) Receive results in this format. Defaults to json. WSI Max users will need to use csv.
• apikey
  • (Required) Your account's API key.