Grid Intensity Lookup

<span class="api-method api-method-get">GET</span> /v1/electricity/grid

Returns all available grid carbon intensity factors, ranked from lowest to highest emissions.


Request

This endpoint has no required parameters. It returns all countries.

Optional Parameters

Parameter Type Description
region string Filter by region: europe, north_america, asia, oceania, africa, south_america

Example Request

curl "https://api.emissions.dev/v1/electricity/grid" \
  -H "Authorization: Bearer em_live_xxxxxxxxxxxx"

Example Response

{
  "data": [
    {
      "country_code": "IS",
      "country_name": "Iceland",
      "grid_intensity": 15,
      "unit": "gCO2e/kWh",
      "region": "europe",
      "is_clean_grid": true,
      "is_dirty_grid": false
    },
    {
      "country_code": "NO",
      "country_name": "Norway",
      "grid_intensity": 29,
      "unit": "gCO2e/kWh",
      "region": "europe",
      "is_clean_grid": true,
      "is_dirty_grid": false
    },
    {
      "country_code": "SE",
      "country_name": "Sweden",
      "grid_intensity": 35,
      "unit": "gCO2e/kWh",
      "region": "europe",
      "is_clean_grid": true,
      "is_dirty_grid": false
    },
    {
      "country_code": "FR",
      "country_name": "France",
      "grid_intensity": 42,
      "unit": "gCO2e/kWh",
      "region": "europe",
      "is_clean_grid": true,
      "is_dirty_grid": false
    },
    {
      "country_code": "GB",
      "country_name": "United Kingdom",
      "grid_intensity": 217,
      "unit": "gCO2e/kWh",
      "region": "europe",
      "is_clean_grid": false,
      "is_dirty_grid": false
    },
    {
      "country_code": "DE",
      "country_name": "Germany",
      "grid_intensity": 332,
      "unit": "gCO2e/kWh",
      "region": "europe",
      "is_clean_grid": false,
      "is_dirty_grid": false
    },
    {
      "country_code": "PL",
      "country_name": "Poland",
      "grid_intensity": 592,
      "unit": "gCO2e/kWh",
      "region": "europe",
      "is_clean_grid": false,
      "is_dirty_grid": true
    }
  ],
  "meta": {
    "total_countries": 100,
    "sources": [
      "Ember Global Electricity Review 2025",
      "EPA eGRID 2023"
    ],
  }
}

Response Fields

Field Type Description
country_code string ISO 3166-1 alpha-2 country code
country_name string Full country name
grid_intensity number Carbon intensity in gCO₂e per kWh
unit string Always gCO2e/kWh
region string Geographic region
is_clean_grid boolean true if intensity < 100 gCO₂e/kWh
is_dirty_grid boolean true if intensity > 500 gCO₂e/kWh

Grid Classification

Classification Threshold Examples
Clean < 100 gCO₂e/kWh Iceland, Norway, Sweden, France, Switzerland
Moderate 100–500 gCO₂e/kWh UK, Germany, US, Japan
Dirty > 500 gCO₂e/kWh Poland, India, South Africa, Indonesia

Use Cases

Build a country selector

Use this endpoint to populate a dropdown of countries with their grid intensities, so users can see the carbon impact before selecting a location.

Data centre site selection

Compare grid intensities across countries to choose the lowest-carbon location for new infrastructure.

Benchmarking

Show clients how their country's grid compares to regional or global averages.


Data Sources

Source Coverage Last Updated
Ember Global Electricity Review 2025 100+ countries (European focus) February 2025
EPA eGRID 2023 US national + 50 states January 2025
DEFRA 2025 UK-specific WTT factors June 2025
Electricity Maps Cloud provider regions Ongoing