API documentation

Read-only JSON API for published PPA data. No authentication required. Rate-limited to 60 requests/minute per IP.

GET /api/v1/ppas

List published, active PPAs. Paginated.

Query parameters

  • q — free-text search (project name, developer, reference code, location)
  • technology — e.g. solar_pv, wind, hydro
  • tariff — e.g. capacity_and_energy, energy_only
  • developer — partial match
  • year — financial close year
  • risk_features[] — e.g. take_or_pay, government_guarantee
  • min_capacity / max_capacity — MW range
  • sort — name_asc, name_desc, capacity_asc, capacity_desc, recent, oldest
  • per_page — default 25
curl "https://staging.energymin.gov.gh/api/v1/ppas?technology=solar_pv&sort=capacity_desc"

GET /api/v1/ppas/{slug}

Single PPA by slug, including procurement details, version history, and public documents. 404 if not published.

curl "https://staging.energymin.gov.gh/api/v1/ppas/example-ppa-slug"

GET /api/v1/ppas/statistics

Portfolio-wide statistics (capacity by technology/year, fiscal exposure, tariff mix) for published, active PPAs.

curl "https://staging.energymin.gov.gh/api/v1/ppas/statistics"