List covered electricity zones
list_zonesCheck if an electricity zone code is covered and list all supported zones. Shows data source, resolution, factor basis, and comparability for 45 grids across Europe, US, and Great Britain.
Instructions
List every electricity zone gridcarbon covers, with its upstream data source, its reporting resolution, and whether its numbers are comparable with the rest.
Call this whenever you are not certain a zone code exists. The data tools reject unknown codes on purpose — there is no sensible fallback, and substituting a neighbouring country's grid would be a fabrication.
Coverage is 45 zones: continental Europe + Nordics + Ireland (ENTSO-E), 10 US balancing authorities plus a Lower-48 aggregate (EIA), and Great Britain (NESO). There is NO coverage of Canada, Australia, Japan, China, India, Latin America or Africa.
This tool returns no measurements itself, but the values the other tools return follow one contract: the unit is gCO2eq/kWh and LOWER IS CLEANER; each value's "ts" is the START of its reporting interval in UTC; and "latest" means NEWEST PUBLISHED, NOT "now" — see typical_lag_hours below and always quote the timestamp with the number.
Two things this list tells you that matter for correctness:
factor_basis: "lifecycle" for 44 zones (IPCC AR5, includes construction and fuel supply chain) versus "operational" for GB (combustion only). GB values come from NESO and use OPERATIONAL (combustion-only) emission factors, not the IPCC AR5 lifecycle factors used for the other 44 zones. GB numbers are systematically lower and MUST NOT be compared or ranked against other zones.
typical_lag_hours: how far behind real time that source normally publishes. US zones are routinely ~1 day behind. This is normal, not an outage — but it means a US value must never be described as "right now".
Args:
source ("entsoe" | "eia" | "uk-neso", optional): filter by upstream provider.
search (string, optional): case-insensitive substring over zone code and name.
response_format ("markdown" | "json", default "markdown").
Returns (structured): { "count": 45, "total_covered": 45, "zones": [ { "zone": "DE", "name": "Germany-Luxembourg", "source": "entsoe", "resolution_min": 60, "factor_basis": "lifecycle", "typical_lag_hours": 4, "comparable_with_others": true }, { "zone": "GB", "name": "Great Britain", "source": "uk-neso", "resolution_min": 30, "factor_basis": "operational", "typical_lag_hours": 2, "comparable_with_others": false } ], "history_starts_at": "2026-08-21T00:00:00Z", "notes": [...] }
Examples:
"Which US grids do you cover?" -> source="eia"
"Do you have Italy?" -> search="italy" (returns the 7 Italian bidding zones)
"Is Japan supported?" -> search="japan" returns zero rows; say it is not covered.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search | No | Case-insensitive substring filter over the zone code and the zone name, e.g. 'italy', 'NO-', 'iso'. | |
| source | No | Only return zones from this upstream source. 'entsoe' = Europe, 'eia' = United States, 'uk-neso' = Great Britain. | |
| response_format | No | Output format for the text content. 'markdown' is compact and human-readable; 'json' returns the full structured payload as text. Structured data is always returned alongside either way. | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| notes | Yes | ||
| zones | Yes | ||
| total_covered | Yes | ||
| history_starts_at | Yes |