---
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`

## Request

- Base URL: `http://api-server-svc.default.svc.cluster.local`
- URL: `http://api-server-svc.default.svc.cluster.local/emissions/average-carbon-intensity`
- Auth: none declared

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.dev/azure/apis/carbonaware-webapi-version-1-0-0-0-culture-neutral-publickey.md) - [All operations](https://skmtc.dev/azure/apis/carbonaware-webapi-version-1-0-0-0-culture-neutral-publickey/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/carbonaware-webapi-version-1-0-0-0-culture-neutral-publickey/revisions/5b8513db900a?raw)