---
title: "Get stale flags chart data"
method: GET
path: "/api/v2/engineering-insights/charts/flags/stale"
tags: ["Insights charts (beta)"]
---

# Get stale flags chart data

`GET /api/v2/engineering-insights/charts/flags/stale`

Get stale flags chart data. Engineering insights displays stale flags data in the [flag health metric view](https://launchdarkly.com/docs/home/observability/flag-health).

### Expanding the chart response

LaunchDarkly supports expanding the chart response to include additional fields.

To expand the response, append the `expand` query parameter and include the following:

* `metrics` includes details on the metrics related to stale flags

For example, use `?expand=metrics` to include the `metrics` field in the response. By default, this field is **not** included in the response.

## Query parameters

- `projectKey` string, string, required — The project key
- `environmentKey` string, string, required — The environment key
- `applicationKey` string, string — Comma separated list of application keys
- `groupBy` string, string — Property to group results by. Options: `maintainer`
- `maintainerId` string, string — Comma-separated list of individual maintainers to filter results.
- `maintainerTeamKey` string, string — Comma-separated list of team maintainer keys to filter results.
- `expand` string, string — Options: `metrics`

## Response `200`

Chart response

- InsightsChart
  - `metadata` InsightsChartMetadata, required
    - `summary` InsightsChartMetadataCustomValues, required
    - `name` string — Name of the chart
    - `metrics` InsightsChartMetrics
    - `xAxis` InsightsChartSeriesMetadataAxis, required
      - `unit` string, required — Unit of the axis
    - `yAxis` InsightsChartSeriesMetadataAxis, required
      - `unit` string, required — Unit of the axis
  - `series` InsightsChartSeries[], required — Series data for the chart
    - `metadata` InsightsChartSeriesMetadata, required
      - `name` string, required — Name of the series
      - `count` integer — Aggregate count of the series values
      - `bounds` InsightsChartBounds[] — Bounds for the series data
        - `name` string, required — Name of the bound
        - `value` integer, required — Value of the bound
    - `data` InsightsChartSeriesDataPoint[], required — Data points for the series
      - `x` integer, required — X-axis value
      - `y` integer, required — Y-axis value
      - `values` object — Additional values for the data point

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `403` — Forbidden
- `404` — Invalid resource identifier
- `429` — Rate limited

---

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