---
title: "Given an array of request objects, each with their own location and time boundaries, calculate the average carbon intensity for that location and time period 
and return an array of carbon intensity objects."
method: POST
path: "/emissions/average-carbon-intensity/batch"
tags: ["CarbonAware"]
---

# Given an array of request objects, each with their own location and time boundaries, calculate the average carbon intensity for that location and time period 
and return an array of carbon intensity objects.

`POST /emissions/average-carbon-intensity/batch`

The application only supports batching across a single location with different time boundaries. If multiple locations are provided, an error is returned.
For each item in the request array, the application returns a corresponding object containing the location, time boundaries, and average marginal carbon intensity.

## Request body

- CarbonIntensityBatchParametersDTO[]
  - `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

## Response `200`

Returns an array of objects where each contains location, time boundaries and the corresponding 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)