{"uid":"cap_pLoB9QhhvOn11szWatj4O","slug":"irena-renewable-energy-statistics-by-country-63bc7169","name":"IRENA Renewable Energy Statistics by Country","description":"IRENA renewable energy statistics for one country: installed electrical capacity (MW) and electricity generation (GWh) by technology (total renewable, solar PV, onshore and offshore wind, hydropower, bioenergy, geothermal and more) for recent years, from IRENA's public IRENASTAT database. Levelised generation costs (LCOE) are not in this API and are not included.","url":"https://api.tradeenergy-api.workers.dev/api/energy/irena-renewable-cost-db?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"years":{"type":"string","description":"Most recent years to return, 1 to 10 (default 3)"},"country":{"type":"string","description":"ISO 3166 alpha-3 country code, e.g. TUR, DEU, USA (required)"},"technology":{"type":"string","description":"Optional words to match technologies, comma separated, e.g. solar,wind (default: total renewable, solar PV, onshore wind, renewable hydropower)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"source":"https://pxweb.irena.org/api/v1/en/IRENASTAT/Power%20Capacity%20and%20Generation/Country_ELECSTAT_2026_H2_PX.px","country":"TUR","citation":"IRENA (2026), Renewable Energy Statistics 2026, International Renewable Energy Agency (IRENA), Abu Dhabi.","checkedAt":"2026-10-23T09:38:25.510Z","countryName":"Türkiye","technologies":[{"years":[{"year":2025,"capacityMw":76300.12,"generationGwh":null},{"year":2024,"capacityMw":69086.62,"generationGwh":162897.17}],"technology":"Total Renewable"},{"years":[{"year":2025,"capacityMw":32293.96,"generationGwh":null},{"year":2024,"capacityMw":32202.96,"generationGwh":74853.18}],"technology":"Renewable hydropower"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1m3Lp23T6IbrTD9Gk_hAI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns IRENA renewable energy statistics for a single country: installed electrical capacity (MW) and electricity generation (GWh) by technology for recent years, sourced from IRENASTAT.","exampleAgentPrompt":"Pull the IRENA renewable energy stats for Germany — I want installed capacity in MW and electricity generation in GWh for solar PV and onshore wind over the last 5 years.","exampleUseCases":[{"title":"Country renewable energy mix assessment","prompt":"Get me IRENA renewable energy statistics for India — I want total renewable, solar PV, and wind capacity in MW plus generation in GWh for the last 5 years."},{"title":"Hydropower generation trend lookup","prompt":"What does IRENASTAT show for Brazil's renewable hydropower electricity generation over the past 3 years? Give me both capacity and generation figures."},{"title":"Geothermal and bioenergy capacity research","prompt":"Fetch IRENA data for Kenya covering geothermal and bioenergy installed capacity and generation for the most recent 4 years — I'm researching East African renewables."}],"resultDescription":"A JSON object containing the country name, ISO code, data source URL, IRENA citation string, and a list of technology entries — each with technology name and per-year records showing installed capacity in MW and electricity generation in GWh. The most recent year may have capacity data but null generation (not yet finalized).","failureModes":["Invalid or unsupported ISO 3166 alpha-3 country code returns an error or empty result","Requested technology filter matches no known IRENA technology category, returning empty technologies array","Most recent year has null generationGwh because IRENA has not yet published final generation data","IRENASTAT upstream API unavailable, causing timeout or 5xx error","Requesting more than 10 years rejected by schema validation"],"whenToPreferThis":"Choose this endpoint when you need official, citable IRENA renewable energy statistics — specifically installed capacity (MW) and generation (GWh) by technology for a single country. It is ideal for policy research, sustainability reporting, and energy analysis grounded in internationally recognized data. It does not provide LCOE/cost data; use alternative endpoints for pricing metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:41.869Z","isFirstParty":false,"canonicalSlug":"irena-renewable-energy-statistics-by-country-63bc7169"}