# 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/zh-cn/docs/atlas/app-services/billing) purposes.


## Servers
- The root API resource and starting point for the App Services API.: https://services.cloud.mongodb.com/api/admin/v3.0 (The root API resource and starting point for the App Services API.)


## Authentication methods
- Token auth


## Parameters

### Path parameters
- **groupId** (string)
  An Atlas [Project/Group
  ID](https://docs.atlas.mongodb.com/tutorial/manage-projects/).

### Query parameters
- **start** (string)
  The ISO 8601 date and time of the start of the query period. Default is
  00:00:00 UTC on the first day of the current month.
- **end** (string)
  The ISO 8601 date and time of the end of the query period. Default is
  23:59:59 UTC on the last day of the current month.
- **granularity** (string)
  Specifies the granularity of the query period, either P31D (31 day) or
  PT1H (1 hour). Default is P31D.


## Responses
### 200
The measurements were successfully returned.

#### Body: application/json (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** (array[object])
  The array of measurements.

### 400
There is an error in the request.

#### Body: application/json (object)
- **error** (string)
  A message that describes the error.
- **error_code** (string)
  The error type.


[Powered by Bump.sh](https://bump.sh)