African Power Grid Signals API

Query the latest available grid-generation and outage observations for Nigeria and South Africa, alongside historical energy indicators.

Current Power Signals

Use the energy indicators for historical trends and the country signals endpoint for the latest available grid and outage observations. Reporting periods vary by source.

Use the regular indicator/data endpoints for:

electricity access
energy consumption
renewable energy share
grid efficiency and losses

Use /v1/countries/{country_code}/signals for available observations such as:

load shedding stage
energy availability factor
peak and off-peak grid generation
peak and off-peak grid frequency
daily energy generated
daily energy sent out
unplanned generation outages
planned maintenance

Country and metric coverage

Nigeria
- peak_grid_generation_mw
- peak_grid_frequency_hz
- off_peak_grid_generation_mw
- off_peak_grid_frequency_hz
- daily_energy_generated_mwh
- daily_energy_sent_out_mwh
South Africa
- load_shedding_stage
- energy_availability_factor_pct
- unplanned_generation_outages_mw
- planned_generation_maintenance_mw

Example

Nigeria Signals

curl "https://api.africa-api.com/v1/countries/ng/signals" \
  -H "Authorization: Bearer $AFRICA_API_KEY"

South Africa Signals

curl "https://api.africa-api.com/v1/countries/za/signals" \
  -H "Authorization: Bearer $AFRICA_API_KEY"

Reporting periods

Check each observation's source and as_of_period before displaying grid conditions. A latest available statement may describe an earlier day. Use /v1/data for annual energy series.

Signals

See how current power-system data appears in the country snapshot payload.

Energy

Use the broader energy indicator guide for annual and structural metrics.

Power