Skip to main content

​
Quick Start

Get up and running with the Power Signals API in three steps.

​
1. Create an Account

Sign up at powersignals.co.za.

​
2. Get an API Key

Navigate to your dashboard and click Create under API Keys. Give it a descriptive name (e.g. “Development”).
Copy your API key immediately — it is only shown once at creation time.

​
3. Make Your First Request

curl -X GET "https://api.powersignals.co.za/api/v1/grid/system-state?start=2026-01-01T00:00:00Z&end=2026-01-01T06:00:00Z&interval=1h" \
  -H "X-API-KEY: your_api_key_here"

​
Response Format

All API responses follow a consistent envelope: 
{
  "meta": {
    "dataset": "grid.system_state",
    "interval": "1h",
    "timezone": "UTC",
    "schema_version": "1.0",
    "start": "2026-01-01T00:00:00+00:00",
    "end": "2026-01-01T06:00:00+00:00"
  },
  "data": [
    {
      "ts": "2026-01-01T00:00:00Z",
      "residual_demand_mw": 28450.0,
      "thermal_mw": 22100.0,
      "nuclear_mw": 1800.0,
      "total_re_mw": 3200.0,
      "..."
    }
  ]
}

​
Next Steps