Skip to main content
GET
Get grid system state

Overview

Returns South African grid system state data for a given time range. This covers residual demand, imports/exports, total renewable generation, and derived grid metrics (renewable share, OCGT ramp, forecast error). For the per-fuel-type generation breakdown, see Generation Mix.

Use Cases

  • Monitor the current state of the South African power grid
  • Track renewable energy penetration over time
  • Detect OCGT ramp events (indicators of grid stress)
  • Build energy forecasting models with historical data

Intervals

Data Fields (Hourly)

Each record in the data array contains:

Authorizations

X-API-KEY
string
header
required

API key obtained from the Power Signals dashboard.

Query Parameters

end
string
required

End datetime in ISO-8601 format (e.g. 2026-01-02T00:00:00Z).

interval
enum<string>

Data resolution. Defaults to 1h.

Available options:
1d,
1h
start
string
required

Start datetime in ISO-8601 format (e.g. 2026-01-01T00:00:00Z).

Response

meta
object
required
data
object[]
required