Skip to main content
GET
/
v1
/
sites
/
{siteId}
/
emissions
Emissions data for a specific site
curl --request GET \
  --url https://api.voltview.co.uk/v1/sites/{siteId}/emissions \
  --header 'x-api-key: <api-key>'
{
  "siteId": "<string>",
  "period": "<string>",
  "emissions": 123,
  "emissionsIntensity": 123,
  "emissionsBySource": {
    "electricity": 123,
    "gas": 123,
    "other": 123
  },
  "historicalData": [
    {
      "period": "<string>",
      "emissions": 123
    }
  ],
  "carbonSavings": 123,
  "targetReduction": 123
}

Authorizations

x-api-key
string
header
required

VoltView API key

Path Parameters

siteId
string
required

Site identifier

Query Parameters

lookback
string

Time period to look back (e.g. 1d, 1w, 1m, 1y for day, week, month, year)

Pattern: ^\d+[dwmy]$
Example:

"1y"

Response

Emissions data retrieved successfully

siteId
string

Site identifier

period
string

Reporting period

emissions
number

Carbon emissions in kg CO2e

emissionsIntensity
number

Emissions intensity in kg CO2e/kWh

emissionsBySource
object

Breakdown of emissions by source

historicalData
object[]

Historical emissions data for comparison

carbonSavings
number

Carbon savings compared to baseline in kg CO2e

targetReduction
number

Target reduction percentage