Outages

List Active Outages

get

List scheduled transmission outages that overlap a time window.

Path parameters

market_idstringRequired

Market id (e.g. pjm). Determines outage + coordinates datasets.

Query parameters

start_timestring · date-timeRequired

Inclusive start of a half-open window (ISO 8601, UTC). Use with end_time. Tickets whose displayed interval overlaps [start_time, end_time) are returned. Also the reconstruction as-of cutoff (version/change times <= start_time).

end_timestring · date-timeRequired

Exclusive end of a half-open window (ISO 8601, UTC).

start_datestring · date-time · nullableOptional

Optional inclusive lower bound on the ticket's displayed current_interval_start_utc (ISO 8601, UTC). When omitted, outages that started at any time are included.

limitinteger · min: 1 · max: 100000Optional

Maximum number of tickets to return. When more tickets match, truncated is true and tickets is trimmed to this limit. Each returned ticket includes its full equipment list.

Default: 50000

api_keystring · nullableOptional

API key for authentication (query)

Header parameters

x-api-keystring · nullableOptional

API key for authentication (header)

Responses

200

Successful Response

application/json

truncatedbooleanRequired

422

Validation Error

application/json

get/outages/{market_id}/active

GET /v1/outages/{market_id}/active?start_time=2026-01-01T00%3A00%3A00.000Z&end_time=2026-01-01T00%3A00%3A00.000Z HTTP/1.1
Host: api.gridstatus.io
Accept: */*

{
  "truncated": true,
  "tickets": [
    {
      "ticket": 1,
      "status": "text",
      "outage_type": "text",
      "version_time_utc": "2026-01-01T00:00:00.000Z",
      "current_interval_start_utc": "2026-01-01T00:00:00.000Z",
      "current_interval_end_utc": "2026-01-01T00:00:00.000Z",
      "causes": [
        "text"
      ],
      "equipment": [
        {
          "zone": "text",
          "facility_name": "text",
          "equipment_type": "text",
          "station_1": "text",
          "station_2": "text",
          "from_substation": {
            "latitude": 1,
            "longitude": 1,
            "name": "text"
          },
          "to_substation": {
            "latitude": 1,
            "longitude": 1,
            "name": "text"
          },
          "voltage": 1,
          "equipment_name": "text",
          "switching_action": "text",
          "interval_start_utc": "2026-01-01T00:00:00.000Z",
          "interval_end_utc": "2026-01-01T00:00:00.000Z"
        }
      ]
    }
  ]
}