---
title: "Get MAU clientside usage"
method: GET
path: "/api/v2/usage/clientside-mau"
tags: ["Account usage (beta)"]
---

# Get MAU clientside usage

`GET /api/v2/usage/clientside-mau`

Get a time series of the number of context key usages observed by LaunchDarkly in your account, for the primary context kind only. The counts reflect data reported from client-side SDKs.<br/><br/>For past months, the primary context kind is fixed and reflects the last known primary kind for that month. For the current month, it may vary as new primary context kinds are observed.<br/><br/>The supported granularity varies by aggregation type. The maximum time range is 365 days.

## Query parameters

- `from` string, string — The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
- `to` string, string — The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- `projectKey` string, string — A project key to filter results by. Can be specified multiple times, one query parameter per project key.
- `environmentKey` string, string — An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
- `sdkName` string, string — An SDK name to filter results by. Can be specified multiple times, one query parameter per SDK name.
- `anonymous` string, string — An anonymous value to filter results by. Can be specified multiple times, one query parameter per anonymous value.<br/>Valid values: `true`, `false`.
- `groupBy` string, string — If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `sdkName`, `sdkAppId`, `anonymousV2`.
- `aggregationType` string, string — Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`, `rolling_30d`.
- `granularity` string, string — Specifies the data granularity. Defaults to `daily`. Valid values depend on `aggregationType`: **month_to_date** supports `daily` and `monthly`; **incremental** and **rolling_30d** support `daily` only.

## Response `200`

Usage response

- SeriesListRep
  - `_links` object, required — The location and content type of related resources
  - `metadata` SeriesMetadataRep[], required — Metadata about each series
  - `series` SeriesTimeSliceRep[], required — An array of data points with timestamps. Each element of the array is an object with a 'time' field, whose value is the timestamp, and one or more key fields. If there are multiple key fields, they are labeled '0', '1', and so on, and are explained in the <code>metadata</code>.

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `403` — Forbidden
- `429` — Rate limited
- `503` — Service unavailable

---

[API](https://skmtc.net/launchdarkly/apis/launchdarkly-rest-api.md) · [All operations](https://skmtc.net/launchdarkly/apis/launchdarkly-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/launchdarkly/launchdarkly-rest-api/versions/69c5c9aafe78/schema)