---
title: "Get data export events usage"
method: GET
path: "/api/v2/usage/data-export-events"
tags: ["Account usage (beta)"]
---

# Get data export events usage

`GET /api/v2/usage/data-export-events`

Get a time series array showing the number of data export events from your account. 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.
- `eventKind` string, string — An event kind to filter results by. Can be specified multiple times, one query parameter per event kind.
- `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: `environmentId`, `eventKind`.
- `aggregationType` string, string — Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
- `granularity` string, string — Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.

## 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)