Introduction
Welcome to the CO2 Signal API! You can use our API to get access to information about
- where the electricity in a specific region comes from
- how it was produced
- how much carbon was emitted to produce it
Authentication
To authorize, use this code:
# With shell, you can just pass the correct header with each request
curl 'https://api.co2signal.com/v1/latest?countryCode=DK-DK1'
-H 'auth-token: myapitoken'
Make sure to replace
myapitoken
with your API key.
CO2 Signal uses API keys to allow access to the API. You can get an API key here.
CO2 Signal expects the API key to be included as a header in all requests to the server:
auth-token: myapitoken
Routes
Get latest by country code
curl 'https://api.co2signal.com/v1/latest?countryCode=FR'
-H 'auth-token: myapitoken'
The above command returns JSON structured like this:
{
"countryCode": "FR",
"data": {
"carbonIntensity": 92.97078744790771,
"datetime": "2017-02-09T08:30:00.000Z",
"fossilFuelPercentage": 12.028887656434616
},
"status": "ok",
"units": {
"carbonIntensity": "gCO2eq/kWh"
}
}
This endpoint retrieves the last known state of a country. It is also possible to get data for a specific zone, in case the country is divided by zones on electricitymap.org.
See http://api.electricitymap.org/v3/zones for list of available zones.
HTTP Request
GET https://api.co2signal.com/v1/latest
Query Parameters
Parameter | Default | Description |
---|---|---|
countryCode | two-letter iso country code |
Get latest by geographic coordinate
curl 'https://api.co2signal.com/v1/latest?lon=6.8770394&lat=45.9162776'
-H 'auth-token: myapitoken'
The above command returns JSON structured like this:
{
"countryCode": "FR",
"data": {
"carbonIntensity": 93.0727344671727,
"datetime": "2017-02-09T08:30:00.000Z",
"fossilFuelPercentage": 12.032514442152996
},
"status": "ok",
"units": {
"carbonIntensity": "gCO2eq/kWh"
}
}
This endpoint retrieves the last known state of the zone. Currently we default to zones by country, but this will quickly evolve to be as granular as possible.
HTTP Request
GET https://api.co2signal.com/v1/latest
Query Parameters
Parameter | Default | Description |
---|---|---|
lon | longitude | |
lat | latitude |