---
title: "Query the benchmark key for a given DORA Metric"
method: GET
path: "/benchmark"
tags: ["summary"]
---

# Query the benchmark key for a given DORA Metric

`GET /benchmark`

Returns a key corresponding to the benchmark calculated from the data points that match the filters. 
The metrics currently supported are below:

| Metric Type | Description                   | Benchmark keys                                 |
| ----------- | ------------------------------| ---------------------------------------------- |
| `df`        | Deployment frequency.         | on-demand, week-month, month-6month, lt-6month |
| `mltc`      | Median lead time for changes. | lt-1hour, lt-1week, week-6month, mt-6month     |
| `cfr`       | Change Failure Rate.          | lt-15p, 15-25p, 25-30p, mt-30p                 |       
| `mttr`      | Mean Time to Recovery         | lt-1hour, lt-1day, day-week, mt-6month         |

## Query parameters

- `type` 'df' | 'mltc' | 'cfr' | 'mttr', required
- `project` string
- `team` string
- `from` string, date-time
- `to` string, date-time

## Headers

- `x-correlation-id` string, uuid

## Response `200`

Success

- BenchmarkResponse
  - `key` string, required — month-6month would correspond to the text "Between once per month and once every 6 months" for example.

## Other responses

- `400` — Bad request
- `500` — Internal error

## Changes

- **2026-07-17** `a8310fb95eab` — 1 info
  - added the new enum value `mttr` to the `query` request parameter `type`
- **2024-03-15** `2cfd6e049308` — 2 info
  - added the new enum value `cfr` to the `query` request parameter `type`
  - added the new enum value `mltc` to the `query` request parameter `type`
- **2023-11-08** `d9a7882c569c` — 1 info
  - endpoint added
- **2023-09-21** `c4f581534821` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/devoteamnl/apis/devoteam-dora-metrics-api/changes/benchmark/get.md)

---

[API](https://skmtc.dev/devoteamnl/apis/devoteam-dora-metrics-api.md) · [All operations](https://skmtc.dev/devoteamnl/apis/devoteam-dora-metrics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/devoteamnl/devoteam-dora-metrics-api/revisions/a8310fb95eab/schema)