---
title: "Get organization emissions data"
method: GET
path: "/organization/{organization_id}/emissions"
tags: ["OrganizationEmissions"]
---

# Get organization emissions data

`GET /organization/{organization_id}/emissions`

> This endpoint **may be changed or removed at any time**. Don't use it in production environments.

## Path parameters

- `organization_id` string, required

## Query parameters

- `project_id` unknown[]
  - unknown
- `billing_group_id` unknown[]
  - unknown
- `starting_time` string
- `ending_time` string
- `granularity` 'day' | 'month'
- `group_by` 'none' | 'project' | 'billing_group'

## Response `200`

Response

- OrganizationEmissionsGetResponse — OrganizationEmissionsGetResponse
  - `ending_time` string, required — End of the query period (exclusive)
  - `granularity` 'day' | 'month', required — Granularity for emissions time buckets.
  - `groups` object[], required — When group_by=none, contains a single element with org totals. When group_by=project or billing_group, contains one element per group.
    - `buckets` object[], required — Emissions data broken down by time bucket
      - `bucket_start` string, required — Start of the time bucket
      - `co2eq_kg` number, required — Total CO2 equivalent emissions for this bucket
    - `deleted` boolean — True if the project or billing group has been deleted. Emissions from deleted resources are still included for historical accuracy.
    - `group_name` string — Name of the project or billing group. None for org-level totals.
  - `starting_time` string, required — Start of the query period (inclusive)

## Other responses

- `404` — Resource not found

---

[API](https://skmtc.net/aiven/apis/aiven-api-documentation.md) · [All operations](https://skmtc.net/aiven/apis/aiven-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aiven/aiven-api-documentation/revisions/269a5669335c/schema)