---
title: "Get contexts serverside usage"
method: GET
path: "/api/v2/usage/serverside-contexts"
tags: ["Account usage (beta)"]
---

# Get contexts serverside usage

`GET /api/v2/usage/serverside-contexts`

Get a detailed time series of the number of context key usages observed by LaunchDarkly in your account, including non-primary context kinds. Use this for breakdowns that go beyond the primary-only aggregation of MAU endpoints. The counts reflect data reported by server-side SDKs.<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 seconds). Defaults to the beginning of the current month.
- `to` string, string — The series of data returned ends at this timestamp (Unix seconds). 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.
- `contextKind` string, string — A context kind to filter results by. Can be specified multiple times, one query parameter per context kind.
- `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. `contextKind` is always included as a grouping dimension. 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)