---
title: "Get evaluations usage"
method: GET
path: "/api/v2/usage/evaluations/{projectKey}/{environmentKey}/{featureFlagKey}"
tags: ["Account usage (beta)"]
---

# Get evaluations usage

`GET /api/v2/usage/evaluations/{projectKey}/{environmentKey}/{featureFlagKey}`

Get time-series arrays of the number of times a flag is evaluated, broken down by the variation that resulted from that evaluation. The granularity of the data depends on the age of the data requested. If the requested range is within the past two hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.

## Path parameters

- `projectKey` string, string, required — The project key
- `environmentKey` string, string, required — The environment key
- `featureFlagKey` string, string, required — The feature flag key

## Query parameters

- `from` string, string — The series of data returned starts from this timestamp. Defaults to 30 days ago.
- `to` string, string — The series of data returned ends at this timestamp. Defaults to the current time.
- `tz` string, string — The timezone to use for breaks between days when returning daily data.

## 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
- `404` — Invalid resource identifier
- `429` — Rate limited

---

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