Carbon intensity level
Carbon intensity classified as low, moderate or high relative to the zone's own recent average.
Level endpoints answer "is now a good time?" without the caller having to pick a threshold: the carbon intensity is compared against what is normal for that zone, so the same classification is meaningful in a grid that sits at 40 gCO2eq/kWh and in one that sits at 600.
Classification
The reference is the mean of the zone's daily averages over the 10 days ending the day before the datapoint. Each datapoint is then classified by its ratio to that reference:
| Ratio to the 10-day average | level |
|---|---|
| Below 0.85 | low |
| 0.85 to 1.15 | moderate |
| Above 1.15 | high |
low means the grid is cleaner than usual, high means it is dirtier than usual.
If you need the underlying value rather than its classification, use /carbon-intensity.
GETForecast
Get the forecasted carbon intensity level for a zone. Levels are classified on hourly data.
GETLatest
Get the latest carbon intensity level for a zone. Levels are classified on hourly data.
GETPast
Get the carbon intensity level for a zone at a past datetime. Levels are classified on hourly data.
GETPast range
Get the carbon intensity level for a zone over a past range. Levels are classified on hourly data, and the range may not exceed 10 days.