{"openapi":"3.1.0","info":{"title":"Power Plants API","version":"1.0.0","description":"The WRI Global Power Plant Database as an API — 34,900+ power stations across 167 countries (~5,700 GW total capacity). Look up any plant by its WRI/GPPD id (e.g. WRI1000452 → Three Gorges Dam, 22,500 MW hydro); search by name, country, fuel type or capacity range; or find every power station within a radius of any coordinate (great-circle distance, optional fuel filter). Each record carries the installed capacity (MW), primary fuel (Solar, Hydro, Wind, Gas, Coal, Nuclear, …), country, latitude/longitude, commissioning year and owner. Ideal for energy dashboards, ESG/climate analytics, grid and infrastructure tools.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/powerplants-api","description":"oanor gateway"}],"tags":[{"name":"Power Plants"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/nearby":{"get":{"operationId":"get_v1_nearby","tags":["Power Plants"],"summary":"Power plants within a radius of a coordinate","description":"","parameters":[{"name":"lat","in":"query","required":false,"description":"Latitude (-90..90)","schema":{"type":"string"},"example":"52.52"},{"name":"lon","in":"query","required":false,"description":"Longitude (-180..180)","schema":{"type":"string"},"example":"13.40"},{"name":"radius_km","in":"query","required":false,"description":"Search radius in km (1-20000, default 100)","schema":{"type":"string"}},{"name":"fuel","in":"query","required":false,"description":"Optional fuel filter","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 10)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"total":128,"center":{"lat":52.52,"lon":13.4},"results":[{"id":"WRI1005948","fuel":"Gas","name":"Mitte","owner":"Vattenfall Europe Wärme AG","country":"DEU","latitude":52.5117,"longitude":13.4209,"capacity_mw":444,"distance_km":1.7,"country_name":"Germany","commissioning_year":1996},{"id":"WRI1005950","fuel":"Coal","name":"Berlin-Moabit power station","owner":"Vattenfall Europe AG","country":"DEU","latitude":52.5374,"longitude":13.3461,"capacity_mw":89,"distance_km":4.1,"country_name":"Germany","commissioning_year":1990},{"id":"WRI1005951","fuel":"Oil","name":"Moabit (Oil)","owner":"Vattenfall Europe Wärme Aktiengesellschaft","country":"DEU","latitude":52.5374,"longitude":13.3461,"capacity_mw":51,"distance_km":4.1,"country_name":"Germany","commissioning_year":1971},{"id":"WRI1005624","fuel":"Gas","name":"Charlottenburg","owner":"Vattenfall Europe Wärme AG","country":"DEU","latitude":52.5219,"longitude":13.3111,"capacity_mw":633,"distance_km":6,"country_name":"Germany","commissioning_year":1975},{"id":"WRI1005864","fuel":"Coal","name":"Klingenberg","owner":"Vattenfall Europe Wärme Aktiengesellschaft","country":"DEU","latitude":52.4889,"longitude":13.497,"capacity_mw":164,"distance_km":7.4,"country_name":"Germany","commissioning_year":1981},{"id":"WRI1006145","fuel":"Oil","name":"Wilmersdorf","owner":"Vattenfall Europe Wärme AG","country":"DEU","latitude":52.4816,"longitude":13.3076,"capacity_mw":828,"distance_km":7.6,"country_name":"Germany","commissioning_year":1977},{"id":"WRI1006022","fuel":"Coal","name":"Berlin-Reuter power station","owner":"Vattenfall Europe AG","country":"DEU","latitude":52.5321,"longitude":13.2461,"capacity_mw":124,"distance_km":10.5,"country_name":"Germany","commissioning_year":1969},{"id":"WRI1006023","fuel":"Waste","name":"Reuter Waste Facility","owner":"Vattenfall Europe Wärme Aktiengesellschaft","country":"DEU","latitude":52.5321,"longitude":13.2461,"capacity_mw":36,"distance_km":10.5,"country_name":"Germany","commissioning_year":1998},{"id":"WRI1006024","fuel":"Coal","name":"Berlin-Reuter-West power station","owner":"Vattenfall Europe AG","country":"DEU","latitude":52.5351,"longitude":13.2426,"capacity_mw":564,"distance_km":10.8,"country_name":"Germany","commissioning_year":1988},{"id":"WRI1005934","fuel":"Gas","name":"Lichterfelde","owner":"Vattenfall Europe Wärme AG","country":"DEU","latitude":52.4252,"longitude":13.3098,"capacity_mw":432,"distance_km":12.2,"country_name":"Germany"}],"radius_km":100},"meta":{"timestamp":"2026-05-31T03:47:07.191Z","request_id":"1f197f10-00e8-4dfe-a7f5-e44e21d94212"},"status":"ok","message":"Nearby power plants listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/plant":{"get":{"operationId":"get_v1_plant","tags":["Power Plants"],"summary":"A single power plant by WRI/GPPD id","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"WRI/GPPD identifier, e.g. WRI1000452 (Three Gorges Dam)","schema":{"type":"string"},"example":"WRI1000452"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"WRI1000452","fuel":"Hydro","name":"Three Gorges Dam","country":"CHN","latitude":30.8235,"longitude":111.0032,"capacity_mw":22500,"country_name":"China","commissioning_year":2003},"meta":{"timestamp":"2026-05-31T03:47:07.273Z","request_id":"9ee13cc4-c7b5-401b-be7c-8766d7980550"},"status":"ok","message":"Power plant retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Power Plants"],"summary":"Search by name with country / fuel / capacity filters","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Name / owner search, e.g. hoover","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Country name or ISO3, e.g. Germany or DEU","schema":{"type":"string"}},{"name":"fuel","in":"query","required":false,"description":"Primary fuel: Solar, Hydro, Wind, Gas, Coal, Nuclear, Oil, Biomass…","schema":{"type":"string"},"example":"Nuclear"},{"name":"min_mw","in":"query","required":false,"description":"Minimum capacity in MW","schema":{"type":"string"}},{"name":"max_mw","in":"query","required":false,"description":"Maximum capacity in MW","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"limit":20,"total":195,"offset":0,"filters":{"fuel":"nuclear"},"results":[{"id":"ARG0000029","fuel":"Nuclear","name":"ATUCHA I","owner":"NASA","country":"ARG","latitude":-33.967,"longitude":-59.2059,"capacity_mw":370,"country_name":"Argentina","commissioning_year":1974},{"id":"ARG0000030","fuel":"Nuclear","name":"ATUCHA II","owner":"NASA","country":"ARG","latitude":-33.9674,"longitude":-59.2045,"capacity_mw":745,"country_name":"Argentina","commissioning_year":2014},{"id":"ARG0000112","fuel":"Nuclear","name":"EMBALSE","owner":"NASA","country":"ARG","latitude":-32.2316,"longitude":-64.4422,"capacity_mw":648,"country_name":"Argentina","commissioning_year":1984},{"id":"WRI1019028","fuel":"Nuclear","name":"Armenian-2","owner":"Armenian Nuclear Power Company","country":"ARM","latitude":40.1805,"longitude":44.1498,"capacity_mw":375,"country_name":"Armenia","commissioning_year":1980},{"id":"WRI1002223","fuel":"Nuclear","name":"DOEL 4","country":"BEL","latitude":51.3254,"longitude":4.2597,"capacity_mw":2910,"country_name":"Belgium","commissioning_year":1985},{"id":"WRI1002275","fuel":"Nuclear","name":"TIHANGE 1N","country":"BEL","latitude":50.5342,"longitude":5.2751,"capacity_mw":962,"country_name":"Belgium","commissioning_year":1975},{"id":"WRI1002277","fuel":"Nuclear","name":"TIHANGE 3","country":"BEL","latitude":50.5342,"longitude":5.2751,"capacity_mw":2053.8,"country_name":"Belgium","commissioning_year":1985},{"id":"BRA0000100","fuel":"Nuclear","name":"Almirante Álvaro Alberto - Unidade I (Antiga Angra I)","country":"BRA","latitude":-23.0087,"longitude":-44.4574,"capacity_mw":640,"country_name":"Brazil","commissioning_year":1985},{"id":"BRA0000101","fuel":"Nuclear","name":"Almirante Álvaro Alberto - Unidade II (Antiga Angra II)","country":"BRA","latitude":-23.0072,"longitude":-44.4588,"capacity_mw":1350,"country_name":"Brazil","commissioning_year":2000},{"id":"WRI1008053","fuel":"Nuclear","name":"KOZLODUY","country":"BGR","latitude":43.7438,"longitude":23.7723,"capacity_mw":2000,"country_name":"Bulgaria"},{"id":"CAN0002030","fuel":"Nuclear","name":"Bruce A","owner":"Bruce Power LP","country":"CAN","latitude":44.3391,"longitude":-81.5747,"capacity_mw":3220,"country_name":"Canada"},{"id":"CAN0002031","fuel":"Nuclear","name":"Bruce B","owner":"Bruce Power LP","country":"CAN","latitude":44.319,"longitude":-81.6027,"capacity_mw":3390,"country_name":"Canada"},{"id":"CAN0002043","fuel":"Nuclear","name":"Darlington","country":"CAN","latitude":43.8697,"longitude":-78.7239,"capacity_mw":3740,"country_name":"Canada"},{"id":"CAN0002073","fuel":"Nuclear","name":"Pickering A","country":"CAN","latitude":43.8107,"longitude":-79.0689,"capacity_mw":1084,"country_name":"Canada"},{"id":"CAN0002074","fuel":"Nuclear","name":"Pickering B","country":"CAN","latitude":43.8096,"longitude":-79.0639,"capacity_mw":2160,"country_name":"Canada"},{"id":"CAN0002076","fuel":"Nuclear","name":"Point Lepreau","country":"CAN","latitude":45.0686,"longitude":-66.4543,"capacity_mw":660,"country_name":"Canada"},{"id":"WRI1061016","fuel":"Nuclear","name":"CEFR","country":"CHN","latitude":39.74,"longitude":116.03,"capacity_mw":20,"country_name":"China"},{"id":"WRI1061017","fuel":"Nuclear","name":"Changjiang","country":"CHN","latitude":19.46,"longitude":108.9,"capacity_mw":1220,"country_name":"China"},{"id":"WRI1061018","fuel":"Nuclear","name":"Daya Bay","country":"CHN","latitude":22.6,"longitude":114.54,"capacity_mw":1888,"country_name":"China"},{"id":"WRI1061019","fuel":"Nuclear","name":"Fangchenggang","country":"CHN","latitude":21.67,"longitude":108.56,"capacity_mw":2000,"country_name":"China"}]},"meta":{"timestamp":"2026-05-31T03:47:07.358Z","request_id":"9a9fd6c9-e883-40b9-81f1-b1ec8d99a480"},"status":"ok","message":"Power plants listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals, capacity & fuel breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"id = WRI/GPPD identifier. Capacity in megawatts (MW).","fuels":[{"fuel":"Solar","count":10665},{"fuel":"Hydro","count":7156},{"fuel":"Wind","count":5344},{"fuel":"Gas","count":3998},{"fuel":"Coal","count":2330},{"fuel":"Oil","count":2320},{"fuel":"Biomass","count":1430},{"fuel":"Waste","count":1068},{"fuel":"Nuclear","count":195},{"fuel":"Geothermal","count":189},{"fuel":"Storage","count":135},{"fuel":"Other","count":43},{"fuel":"Cogeneration","count":41},{"fuel":"Petcoke","count":12},{"fuel":"Wave and Tidal","count":10}],"total":34936,"fields":["id","name","country","country_name","capacity_mw","fuel","latitude","longitude","commissioning_year","owner"],"source":"WRI Global Power Plant Database (CC-BY 4.0)","countries":167,"total_capacity_mw":5706975},"meta":{"timestamp":"2026-05-31T03:47:07.417Z","request_id":"edaf7a5a-5e99-4219-9857-8b3955d2fda9"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":750,"monthly_call_quota":40000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2000,"monthly_call_quota":200000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4800,"monthly_call_quota":1000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/powerplants-api"}