{ "openapi": "3.1.0", "info": { "title": "Power Plants API", "version": "1.0.0", "description": "34,936 power plants in 167 countries with capacity, fuel, coordinates and annual generation.\n\nThe world's power infrastructure, queryable. WRI's Global Power Plant Database (CC BY 4.0): 34,936 plants across 167 countries — from the Three Gorges Dam (22,500 MW, the planet's largest) to 10,665 solar farms — each with capacity, coordinates, primary and secondary fuels, commissioning year, owner, and the latest reported annual generation with its year (Hoover Dam NV: 2,175.7 GWh in 2019) plus a model-estimated figure where reporting is absent. Search by name or owner, filter by country, fuel and minimum capacity (USA + Nuclear = 58 plants, Palo Verde first at 4,209.6 MW), pull capacity aggregates by fuel or country (global coal: 2,330 plants, 1.97 TW; nuclear: 195 plants, 408 GW), or ask what's near a point (Las Vegas → a 358.9 MW gas station 7.1 km out). Energy analytics, grid research, ESG screening, site selection, journalism and climate tooling — the reference open dataset for the world's generation fleet.", "contact": { "name": "Data and APIs", "url": "https://dataandapis.com/contact" }, "termsOfService": "https://dataandapis.com/terms-of-service", "license": { "name": "Data and APIs Terms of Service", "url": "https://dataandapis.com/terms-of-service" }, "x-logo": { "url": "https://dataandapis.com/images/power-plants.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/power-plants" }, "servers": [ { "url": "https://api-power-plants.dataandapis.com" } ], "tags": [ { "name": "Data", "description": "Power Plants API belongs to the Data category of the Data and APIs catalog." } ], "paths": { "/v1/power-plants/stats": { "get": { "operationId": "capacityStats", "summary": "Capacity Stats", "description": "Capacity Stats endpoint of the Power Plants API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/power-plants/capacity-stats" }, "parameters": [ { "name": "by", "in": "query", "required": false, "schema": { "type": "string" }, "example": "fuel" }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" }, "example": "USA" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "by": "fuel", "country": "USA", "stats": [ { "group": "Gas", "plants": 1818, "capacity_mw": 546435.8 }, { "group": "Coal", "plants": 286, "capacity_mw": 249149.1 }, { "group": "Wind", "plants": 1139, "capacity_mw": 104476.9 }, { "group": "Nuclear", "plants": 58, "capacity_mw": 104233.1 }, { "group": "Hydro", "plants": 1449, "capacity_mw": 101656.9 }, { "group": "Solar", "plants": 3283, "capacity_mw": 37970.3 }, { "group": "Oil", "plants": 876, "capacity_mw": 37143.4 }, { "group": "Waste", "plants": 541, "capacity_mw": 9768.5 }, { "group": "Biomass", "plants": 153, "capacity_mw": 5123.2 }, { "group": "Geothermal", "plants": 65, "capacity_mw": 3889.2 }, { "group": "Petcoke", "plants": 11, "capacity_mw": 2361.6 }, { "group": "Cogeneration", "plants": 34, "capacity_mw": 1042 }, { "group": "Storage", "plants": 104, "capacity_mw": 815.6 }, { "group": "Other", "plants": 16, "capacity_mw": 572.4 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/sources": { "get": { "operationId": "dataSources", "summary": "Data Sources", "description": "Data Sources endpoint of the Power Plants API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/power-plants/data-sources" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "sources": [ { "slug": "wri-gppd", "name": "Global Power Plant Database v1.3", "publisher": "World Resources Institute", "licence": "CC BY 4.0", "source_url": "https://datasets.wri.org/dataset/globalpowerplantdatabase", "file_url": "https://raw.githubusercontent.com/wri/global-power-plant-database/master/output_database/global_power_plant_database.csv", "cadence": "static release (v1.3, 2021); re-scrape on new release", "record_count": 34936, "retrieved_at": "2026-09-06" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/power-plants/nearest": { "get": { "operationId": "nearestPlants", "summary": "Nearest Plants", "description": "Nearest Plants endpoint of the Power Plants API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/power-plants/nearest-plants" }, "parameters": [ { "name": "lat", "in": "query", "required": true, "schema": { "type": "string" }, "example": "36.17" }, { "name": "lng", "in": "query", "required": true, "schema": { "type": "string" }, "example": "-115.14" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "query": { "lat": 36.17, "lng": -115.14 }, "plants": [ { "id": "USA0010761", "name": "Las Vegas Generating Station", "country": "USA", "country_name": "United States of America", "capacity_mw": 358.9, "lat": 36.2319, "lng": -115.1222, "primary_fuel": "Gas", "other_fuels": [], "commissioning_year": 2001, "owner": "Nevada Power Co", "generation_gwh": 196.104, "generation_year": 2019, "estimated_generation_gwh": 1265.65, "distance_km": 7.1 }, { "id": "USA0057348", "name": "CityCenter Central Plant Cogen Units", "country": "USA", "country_name": "United States of America", "capacity_mw": 8.6, "lat": 36.1039, "lng": -115.1794, "primary_fuel": "Gas", "other_fuels": [], "commissioning_year": 2010, "owner": "CityCenter Land LLC", "generation_gwh": 63.1296, "generation_year": 2019, "estimated_generation_gwh": 30.32, "distance_km": 8.2 }, { "id": "USA0059919", "name": "Nellis Solar PV II", "country": "USA", "country_name": "United States of America", "capacity_mw": 15, "lat": 36.2067, "lng": -115.0477, "primary_fuel": "Solar", "other_fuels": [], "commissioning_year": 2015, "owner": "Nevada Power Co", "generation_gwh": 39.444, "generation_year": 2019, "estimated_generation_gwh": 37.79, "distance_km": 9.2 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/power-plants/{id}": { "get": { "operationId": "plantDetail", "summary": "Plant Detail", "description": "Plant Detail endpoint of the Power Plants API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/power-plants/plant-detail" }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "example": "USA0000154" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "plant": { "id": "USA0000154", "name": "Hoover Dam (NV)", "country": "USA", "country_name": "United States of America", "capacity_mw": 1039.4, "lat": 36.0155, "lng": -114.738, "primary_fuel": "Hydro", "other_fuels": [], "commissioning_year": 1940, "owner": "U S Bureau of Reclamation", "generation_gwh": 2175.715, "generation_year": 2019, "estimated_generation_gwh": 2537.25 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/power-plants": { "get": { "operationId": "searchPlants", "summary": "Search Plants", "description": "Search Plants endpoint of the Power Plants API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/power-plants/search-plants" }, "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" }, "example": "USA" }, { "name": "fuel", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "min_capacity_mw", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "hoover" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "page": 1, "limit": 25, "total": 2, "total_pages": 1, "units": { "capacity_mw": "MW", "generation_gwh": "GWh/yr" }, "plants": [ { "id": "USA0000154", "name": "Hoover Dam (NV)", "country": "USA", "country_name": "United States of America", "capacity_mw": 1039.4, "lat": 36.0155, "lng": -114.738, "primary_fuel": "Hydro", "other_fuels": [], "commissioning_year": 1940, "owner": "U S Bureau of Reclamation", "generation_gwh": 2175.715, "generation_year": 2019, "estimated_generation_gwh": 2537.25 }, { "id": "USA0008902", "name": "Hoover Dam (AZ)", "country": "USA", "country_name": "United States of America", "capacity_mw": 1039.4, "lat": 36.0155, "lng": -114.738, "primary_fuel": "Hydro", "other_fuels": [], "commissioning_year": 1944, "owner": "U S Bureau of Reclamation", "generation_gwh": 1156.197, "generation_year": 2019, "estimated_generation_gwh": 2537.25 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call." } } }, "security": [ { "ApiKey": [] } ] }