---
title: "List group billing usage in a given period"
method: GET
path: "/groups/{groupId}/measurements"
tags: ["billing"]
---

# List group billing usage in a given period

`GET /groups/{groupId}/measurements`

List the request, compute, sync, and data transfer usage in a given
period for [billing](https://www.mongodb.com/docs/atlas/app-services/billing) purposes.

## Path parameters

- `groupId` string, required

## Query parameters

- `start` string
- `end` string
- `granularity` 'P31D' | 'PT1H'

## Response `200`

The measurements were successfully returned.

- object
  - `start` string — The [RFC 3339](https://tools.ietf.org/html/3339) date and time of the start of the query period, which can be specified with the `start` query parameter.
  - `end` string — The [RFC 3339](https://tools.ietf.org/html/3339) date and time of the end of the query period, which can be specified with the `end` query parameter.
  - `granularity` string — The granularity, which can be specified with the `granularity` query parameter.
  - `group_id` string — The Atlas [Group ID](https://docs.atlas.mongodb.com/tutorial/manage-projects/).
  - `measurements` object[] — The array of measurements.
    - `name` 'request_count' | 'compute_time' | 'data_out' | 'sync_time' — The usage metric represented by each data point. See [billing](https://www.mongodb.com/docs/atlas/app-services/billing).
    - `units` '<empty string>' | 'HOURS' | 'GIGABYTES' — The unit of the `value` of each data point.
    - `data_points` object[] — The array of data points for this measurement. A finer `granularity` results in more data points.
      - `timestamp` string — The ISO 8601 date and time of the data point.
      - `value` number — The value at the time in the `unit` of the measurement.

## Other responses

- `400` — There is an error in the request.

---

[API](https://skmtc.net/mongodb/apis/mongodb-atlas-app-services-admin-api.md) · [All operations](https://skmtc.net/mongodb/apis/mongodb-atlas-app-services-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mongodb/mongodb-atlas-app-services-admin-api/revisions/1365ab72bc03/schema)