---
title: "Retrieves the measured carbon intensity data between the time boundaries and calculates the average carbon intensity during that period."
method: GET
path: "/emissions/average-carbon-intensity"
tags: ["CarbonAware"]
---

# Retrieves the measured carbon intensity data between the time boundaries and calculates the average carbon intensity during that period.

`GET /emissions/average-carbon-intensity`

This endpoint is useful for reporting the measured carbon intensity for a specific time period in a specific location.

## Query parameters

- `location` string, required
- `startTime` string, date-time, required
- `endTime` string, date-time, required

## Response `200`

Returns a single object that contains the information about the request and the average marginal carbon intensity

- CarbonIntensityDTO
  - `location` string, nullable — the location name where workflow is run
  - `startTime` string, date-time, nullable — the time at which the workflow we are measuring carbon intensity for started
  - `endTime` string, date-time, nullable — the time at which the workflow we are measuring carbon intensity for ended
  - `carbonIntensity` number, double — Value of the marginal carbon intensity in grams per kilowatt-hour.

## Other responses

- `400` — Returned if any of the requested items are invalid
- `500` — Internal server error

---

[API](https://skmtc.net/azure/apis/carbonaware-webapi-version-1-0-0-0-culture-neutral-publickey.md) · [All operations](https://skmtc.net/azure/apis/carbonaware-webapi-version-1-0-0-0-culture-neutral-publickey/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/carbonaware-webapi-version-1-0-0-0-culture-neutral-publickey/revisions/5b8513db900a/schema)