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 |