---
title: "Get insight scores"
method: GET
path: "/api/v2/engineering-insights/insights/scores"
tags: ["Insights scores (beta)"]
---

# Get insight scores

`GET /api/v2/engineering-insights/insights/scores`

Return insights scores, based on the given parameters. This data is also used in engineering insights metrics views.

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

## Response `200`

Insight score response

- InsightScores
  - `period` InsightPeriod, required
    - `startTime` integer, required
    - `endTime` integer, required
  - `lastPeriod` InsightPeriod, required
    - `startTime` integer, required
    - `endTime` integer, required
  - `scores` InsightGroupScores, required
    - `overall` InsightsMetricScore, required
      - `score` integer, required — The score for the metric
      - `aggregateOf` string[] — The keys of the metrics that were aggregated to calculate this score
      - `diffVsLastPeriod` integer
      - `indicator` string, required
      - `indicatorRange` InsightsMetricIndicatorRange, required
        - `min` integer, required — The minimum value for the indicator range
        - `max` integer, required — The maximum value for the indicator range
      - `lastPeriod` InsightsMetricScore — recursive
    - `deploymentFrequency` InsightsMetricScore, required
      - `score` integer, required — The score for the metric
      - `aggregateOf` string[] — The keys of the metrics that were aggregated to calculate this score
      - `diffVsLastPeriod` integer
      - `indicator` string, required
      - `indicatorRange` InsightsMetricIndicatorRange, required
        - `min` integer, required — The minimum value for the indicator range
        - `max` integer, required — The maximum value for the indicator range
      - `lastPeriod` InsightsMetricScore — recursive
    - `deploymentFailureRate` InsightsMetricScore, required
      - `score` integer, required — The score for the metric
      - `aggregateOf` string[] — The keys of the metrics that were aggregated to calculate this score
      - `diffVsLastPeriod` integer
      - `indicator` string, required
      - `indicatorRange` InsightsMetricIndicatorRange, required
        - `min` integer, required — The minimum value for the indicator range
        - `max` integer, required — The maximum value for the indicator range
      - `lastPeriod` InsightsMetricScore — recursive
    - `leadTime` InsightsMetricScore, required
      - `score` integer, required — The score for the metric
      - `aggregateOf` string[] — The keys of the metrics that were aggregated to calculate this score
      - `diffVsLastPeriod` integer
      - `indicator` string, required
      - `indicatorRange` InsightsMetricIndicatorRange, required
        - `min` integer, required — The minimum value for the indicator range
        - `max` integer, required — The maximum value for the indicator range
      - `lastPeriod` InsightsMetricScore — recursive
    - `impactSize` InsightsMetricScore, required
      - `score` integer, required — The score for the metric
      - `aggregateOf` string[] — The keys of the metrics that were aggregated to calculate this score
      - `diffVsLastPeriod` integer
      - `indicator` string, required
      - `indicatorRange` InsightsMetricIndicatorRange, required
        - `min` integer, required — The minimum value for the indicator range
        - `max` integer, required — The maximum value for the indicator range
      - `lastPeriod` InsightsMetricScore — recursive
    - `experimentationCoverage` InsightsMetricScore, required
      - `score` integer, required — The score for the metric
      - `aggregateOf` string[] — The keys of the metrics that were aggregated to calculate this score
      - `diffVsLastPeriod` integer
      - `indicator` string, required
      - `indicatorRange` InsightsMetricIndicatorRange, required
        - `min` integer, required — The minimum value for the indicator range
        - `max` integer, required — The maximum value for the indicator range
      - `lastPeriod` InsightsMetricScore — recursive
    - `flagHealth` InsightsMetricScore, required
      - `score` integer, required — The score for the metric
      - `aggregateOf` string[] — The keys of the metrics that were aggregated to calculate this score
      - `diffVsLastPeriod` integer
      - `indicator` string, required
      - `indicatorRange` InsightsMetricIndicatorRange, required
        - `min` integer, required — The minimum value for the indicator range
        - `max` integer, required — The maximum value for the indicator range
      - `lastPeriod` InsightsMetricScore — recursive
    - `velocity` InsightsMetricScore, required
      - `score` integer, required — The score for the metric
      - `aggregateOf` string[] — The keys of the metrics that were aggregated to calculate this score
      - `diffVsLastPeriod` integer
      - `indicator` string, required
      - `indicatorRange` InsightsMetricIndicatorRange, required
        - `min` integer, required — The minimum value for the indicator range
        - `max` integer, required — The maximum value for the indicator range
      - `lastPeriod` InsightsMetricScore — recursive
    - `risk` InsightsMetricScore, required
      - `score` integer, required — The score for the metric
      - `aggregateOf` string[] — The keys of the metrics that were aggregated to calculate this score
      - `diffVsLastPeriod` integer
      - `indicator` string, required
      - `indicatorRange` InsightsMetricIndicatorRange, required
        - `min` integer, required — The minimum value for the indicator range
        - `max` integer, required — The maximum value for the indicator range
      - `lastPeriod` InsightsMetricScore — recursive
    - `efficiency` InsightsMetricScore, required
      - `score` integer, required — The score for the metric
      - `aggregateOf` string[] — The keys of the metrics that were aggregated to calculate this score
      - `diffVsLastPeriod` integer
      - `indicator` string, required
      - `indicatorRange` InsightsMetricIndicatorRange, required
        - `min` integer, required — The minimum value for the indicator range
        - `max` integer, required — The maximum value for the indicator range
      - `lastPeriod` InsightsMetricScore — recursive
    - `creationRatio` InsightsMetricScore
      - `score` integer, required — The score for the metric
      - `aggregateOf` string[] — The keys of the metrics that were aggregated to calculate this score
      - `diffVsLastPeriod` integer
      - `indicator` string, required
      - `indicatorRange` InsightsMetricIndicatorRange, required
        - `min` integer, required — The minimum value for the indicator range
        - `max` integer, required — The maximum value for the indicator range
      - `lastPeriod` InsightsMetricScore — recursive
  - `_links` object — The location and content type of related resources

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `403` — Forbidden
- `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)