---
title: "Query data points for a given DORA Metric"
method: GET
path: "/metric"
tags: ["data-points"]
---

# Query data points for a given DORA Metric

`GET /metric`

Returns the data points for the requested metric according to the informed filters. The below are the metrics currently supported:

| Metric Type     | Description                                                                         |
| --------------- | ----------------------------------------------------------------------------------- |
| `df_average`    | Deployment frequency (average), aggregated according to the `aggregation` parameter |
| `df_count`      | Amount of Deployments, aggregated according to the `aggregation` parameter          |
| `mltc`          | Median Lead Time for Changes, aggregated according to the `aggregation` parameter   |
| `cfr`           | Change Failure Rate, aggregated according to the `aggregation` parameter            | 
| `mttr`          | Mean Time to Recovery, aggregated according to the `aggregation` parameter          |

## Query parameters

- `type` 'df_average' | 'df_count' | 'mltc' | 'cfr' | 'mttr', required
- `aggregation` 'weekly' | 'monthly' | 'quarterly'
- `project` string
- `team` string
- `from` string, date-time
- `to` string, date-time

## Headers

- `x-correlation-id` string, uuid

## Response `200`

Success

- MetricResponse
  - `aggregation` string, required
  - `dataPoints` DataPoint[], required
    - `key` string, required
    - `value` number, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized! Should Provide a valid JWT token
- `403` — Forbidden! Access denied. Do not have authority to call this API
- `500` — Internal error

## Changes

- **2026-07-17** `a8310fb95eab` — 1 info
  - added the new enum value `mttr` to the `query` request parameter `type`
- **2024-02-22** `a41bec754ea2` — 1 info
  - added the new enum value `cfr` to the `query` request parameter `type`
- **2023-12-08** `c817a8cd2d8a` — 1 info
  - added the new enum value `mltc` to the `query` request parameter `type`
- **2023-09-29** `53720d35ff6e` — 1 breaking, 2 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - added the required property `aggregation` to the response with the `200` status
  - added the required property `dataPoints` to the response with the `200` status
- **2023-09-21** `c4f581534821` — 6 breaking
  - removed the enum value `cfr` from the `query` request parameter `type`
  - removed the enum value `mltc` from the `query` request parameter `type`
  - removed the enum value `mttr` from the `query` request parameter `type`
  - the response's body type/format changed from `object`/`` to `array`/`` for status `200`
  - …2 more

[Change history](https://skmtc.dev/devoteamnl/apis/devoteam-dora-metrics-api/changes/metric/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)