Quick Start

Get your first API response in under 2 minutes.

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

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

• Authentication — Learn about API key management and security
• Grid System State — Full endpoint reference
• Rate Limits — Understand request limits and best practices