Get grid system state
Grid
System State
Returns South African grid system state data for the given time range. Supports hourly (1h) and daily (1d) intervals. Requires API key authentication.
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 thedata array contains:
Authorizations
API key obtained from the Power Signals dashboard.
Query Parameters
End datetime in ISO-8601 format (e.g. 2026-01-02T00:00:00Z).
Data resolution. Defaults to 1h.
Available options:
1d, 1h Start datetime in ISO-8601 format (e.g. 2026-01-01T00:00:00Z).

