Location-based

Carbon intensity

GET

https://api.gridco2.com

/v1/co2

Returns the carbon intensity of the current hour at the given coordinates in grams of CO2 equivalent per kWh (gCO2eq/kWh).

Carbon intensity › query Parameters

lat

number · min: -90 · max: 90 · required

Latitude in decimal degrees (WGS84).

lon

number · min: -180 · max: 180 · required

Longitude in decimal degrees (WGS84).

Carbon intensity › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Carbon intensity › Responses

Carbon intensity for the given coordinates.

CarbonIntensity

timestamp

string · date-time

Start of the hour this value applies to (UTC).

carbon_intensity

number

Carbon intensity in grams of CO2 equivalent per kWh (gCO2eq/kWh).

Carbon intensity forecast

GET

https://api.gridco2.com

/v1/co2/forecast

Returns the forecast carbon intensity for the next 24 hours at the given coordinates as hourly values in grams of CO2 equivalent per kWh (gCO2eq/kWh).

Carbon intensity forecast › query Parameters

lat

number · min: -90 · max: 90 · required

Latitude in decimal degrees (WGS84).

lon

number · min: -180 · max: 180 · required

Longitude in decimal degrees (WGS84).

hours

integer · min: 1 · max: 24

Number of hours to forecast ahead, from 1 to 24. Defaults to 24.

Default: 24

Carbon intensity forecast › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Carbon intensity forecast › Responses

Hourly carbon intensity forecast for the given coordinates.

CarbonIntensityForecast

object[]

Hourly forecast points, ordered from the current hour forwards.

Electricity mix

GET

https://api.gridco2.com

/v1/electricitymix

Returns the composition of electricity at the current hour for the given coordinates. Split into the percentages of each source.

Electricity mix › query Parameters

lat

number · min: -90 · max: 90 · required

Latitude in decimal degrees (WGS84).

lon

number · min: -180 · max: 180 · required

Longitude in decimal degrees (WGS84).

Electricity mix › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Electricity mix › Responses

Electricity mix for the given coordinates.

ElectricityMix

timestamp

string · date-time

Start of the hour this value applies to (UTC).

SourceBreakdown

Share of electricity by source, as a percentage. Values sum to 100. Any sources with 0 are omitted.

Electricity mix forecast

GET

https://api.gridco2.com

/v1/electricitymix/forecast

Returns the forecast electricity mix for the next 24 hours at the given coordinates as hourly percentages of each source.

Electricity mix forecast › query Parameters

lat

number · min: -90 · max: 90 · required

Latitude in decimal degrees (WGS84).

lon

number · min: -180 · max: 180 · required

Longitude in decimal degrees (WGS84).

hours

integer · min: 1 · max: 24

Number of hours to forecast ahead, from 1 to 24. Defaults to 24.

Default: 24

Electricity mix forecast › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Electricity mix forecast › Responses

Hourly electricity mix forecast for the given coordinates.

ElectricityMixForecast

object[]

Hourly forecast points, ordered from the current hour forwards.

Datacenters