Electricity Maps

Electricity Maps provides electricity grid data - carbon intensity and power production/consumption breakdown - for 200+ zones worldwide, in real time, as historical series, and as 24-72 hour forecasts. The REST API serves the same data behind the live electricity map at app.electricitymap.org, authenticated with an auth-token header.

5 APIs 0 Features

EnergyCarbon IntensityElectricityGridSustainability

APIs

Electricity Maps Carbon Intensity API

Last-known, 24-hour history, and 24-72 hour forecast carbon intensity (gCO2eq/kWh) of electricity consumed in a zone, queryable by zone identifier or by latitude/longitude geolo...

Electricity Maps Power Breakdown API

Combined power consumption and production breakdown for a zone by source (nuclear, solar, wind, hydro, gas, coal, oil, biomass, geothermal, battery), with import/export flows, a...

Electricity Maps Power Consumption & Production API

Dedicated flow-traced power consumption breakdown and physical power production breakdown endpoints for a zone, reporting megawatts per source and net import/export exchanges wi...

Electricity Maps Zones API

Lists all available zones with the endpoints accessible for the caller's token, plus a health endpoint reporting API status. Both can be requested without an API key.

Electricity Maps Forecast API

24-72 hour ahead forecasts of carbon intensity and power production breakdown for a zone, used to schedule compute and other loads toward lower-carbon hours.

Collections

Electricity Maps API

OPEN

Pricing Plans

Electricitymaps Plans Pricing

4 plans

PLANS

Rate Limits

Electricitymaps Rate Limits

6 limits

RATE LIMITS

FinOps

Electricitymaps Finops

FINOPS

Resources

👥

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: Electricity Maps API
  version: '3.0'
request:
  auth:
    type: apikey
    key: auth-token
    value: '{{authToken}}'
    in: header
items:
- info:
    name: Carbon Intensity
    type: folder
  items:
  - info:
      name: Latest carbon intensity
      type: http
    http:
      method: GET
      url: https://api.electricitymap.org/v3/carbon-intensity/latest?zone=DE
    docs: Retrieves the last known carbon intensity (gCO2eq/kWh) of electricity consumed in a zone, by zone or lat/lon.
  - info:
      name: Carbon intensity history
      type: http
    http:
      method: GET
      url: https://api.electricitymap.org/v3/carbon-intensity/history?zone=DE
    docs: Retrieves the last 24 hours of carbon intensity for a zone at hourly resolution.
  - info:
      name: Carbon intensity forecast
      type: http
    http:
      method: GET
      url: https://api.electricitymap.org/v3/carbon-intensity/forecast?zone=DE
    docs: Retrieves the forecasted carbon intensity for a zone, 24-72 hours ahead depending on plan.
- info:
    name: Power Breakdown
    type: folder
  items:
  - info:
      name: Latest power breakdown
      type: http
    http:
      method: GET
      url: https://api.electricitymap.org/v3/power-breakdown/latest?zone=DE
    docs: Retrieves the last known power consumption and production breakdown of a zone, with import/export flows.
  - info:
      name: Power breakdown history
      type: http
    http:
      method: GET
      url: https://api.electricitymap.org/v3/power-breakdown/history?zone=DE
    docs: Retrieves the last 24 hours of power consumption and production breakdown for a zone at 60-minute resolution.
  - info:
      name: Power breakdown forecast
      type: http
    http:
      method: GET
      url: https://api.electricitymap.org/v3/power-breakdown/forecast?zone=DE
    docs: Retrieves the forecasted power production breakdown for a zone, 24-72 hours ahead depending on plan.
- info:
    name: Power Consumption & Production
    type: folder
  items:
  - info:
      name: Latest power consumption breakdown
      type: http
    http:
      method: GET
      url: https://api.electricitymap.org/v3/power-consumption-breakdown/latest?zone=DE
    docs: Retrieves the last known flow-traced power consumption breakdown of a zone in MW per production type.
  - info:
      name: Latest power production breakdown
      type: http
    http:
      method: GET
      url: https://api.electricitymap.org/v3/power-production-breakdown/latest?zone=DE
    docs: Retrieves the last known physical power production breakdown of a zone in MW per production type.
- info:
    name: Zones & Health
    type: folder
  items:
  - info:
      name: List zones
      type: http
    http:
      method: GET
      url: https://api.electricitymap.org/v3/zones
    docs: Returns all available zones and the endpoints accessible for the caller's token. Can be requested without an API
      key.
  - info:
      name: API health
      type: http
    http:
      method: GET
      url: https://api.electricitymap.org/v3/health
    docs: Returns the operational status of the API. Can be requested without an API key.