# Eskom Load Shedding Status API

> South Africa's current Eskom load shedding stage, plus municipality and suburb lookup for schedules

- Vendor: `eskomloadsheddingstatusapi` · version 1.0 · category Energy · tags eskom api, load shedding api, south africa power api, loadshedding stage api, power outage api, electricity grid api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/eskomloadsheddingstatusapi
- This document: https://apiclay.com/docs/eskomloadsheddingstatusapi.md
- OpenAPI 3.1: https://apiclay.com/api/eskomloadsheddingstatusapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `eskomloadsheddingstatusapi`
- Updated: 2026-11-18

## About

## Eskom Load Shedding Status API

Eskom's public load shedding service: the national load shedding status right now, the municipalities of a province, and a suburb search that returns the suburb ids, municipality and province Eskom uses for its load shedding schedules.

Data comes from **loadshedding.eskom.co.za** (https://loadshedding.eskom.co.za). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/status` (1 means no load shedding, 2 is Stage 1, 3 is Stage 2 ...), `/suburbs?searchText=sandton`.

### Routes

#### GET `/status` - Current status
No parameters.

Returns: a single number: the load shedding stage plus one (`1` = not load shedding, `2` = Stage 1, ... `9` = Stage 8).

#### GET `/municipalities` - Municipalities
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| Id | query | number | yes | Province: 1 Eastern Cape, 2 Free State, 3 Gauteng, 4 KwaZulu-Natal, 5 Limpopo, 6 Mpumalanga, 7 North West, 8 Northern Cape, 9 Western Cape. |

Returns: array of `Text` (municipality name) and `Value` (id).

#### GET `/suburbs` - Suburb search
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| searchText | query | string | yes | Suburb name. |
| maxResults | query | number | no | Results to return. |

Returns: array of `Id`, `Name`, `MunicipalityName`, `ProvinceName`, `Total`.

### Caveats

- Suburbs supplied directly by Eskom only; customers of a municipality (such as City Power) follow the municipality's own schedule.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by loadshedding.eskom.co.za.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /status — Current status
- Gateway: `GET https://api.apiclay.com/v1/api/eskomloadsheddingstatusapi/status`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /municipalities — Municipalities
- Gateway: `GET https://api.apiclay.com/v1/api/eskomloadsheddingstatusapi/municipalities`
- Public query params: `Id` (number, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /suburbs — Suburb search
- Gateway: `GET https://api.apiclay.com/v1/api/eskomloadsheddingstatusapi/suburbs`
- Public query params: `searchText` (string, required), `maxResults` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/eskomloadsheddingstatusapi/status" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
