---
title: "List Metrics Data"
method: GET
path: "/v1/metrics-data"
tags: ["Metrics Data"]
---

# List Metrics Data

`GET /v1/metrics-data`

## Request

- Base URL: `https://api.confident-ai.com`
- URL: `https://api.confident-ai.com/v1/metrics-data`
- Auth: none declared. Required headers: `CONFIDENT_API_KEY`
- TypeScript: <https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/docs/v1/metrics-data/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a paginated list of metric data (evaluation results) from your Confident AI project.

## Query parameters

- `page` integer
- `pageSize` integer
- `start` string, date-time
- `end` string, date-time
- `sortBy` 'createdAt'
- `ascending` 'true' | 'false'

## Headers

- `CONFIDENT_API_KEY` string, required

## Response `200`

Successfully retrieved list of metrics data

- ListMetricsDataResponse
  - `success` boolean, required: Indicates if the request was successful
  - `data` object, required
    - `metricsData` MetricsData[]: List of metric data entries
      - `id` string, required: The unique identifier of the metrics data entry.
      - `projectId` string, required: The project this metric data belongs to.
      - `traceUuid` string, nullable: The UUID of the trace this metric data is associated with, if any.
      - `spanUuid` string, nullable: The UUID of the span this metric data is associated with, if any.
      - `testCaseId` string, nullable: The ID of the test case this metric data is associated with, if any.
      - `testRunId` string, nullable: The ID of the test run this metric data is associated with, if any.
      - `threadId` string, nullable: The ID of the thread this metric data is associated with, if any.
      - `name` string, required: The name of the metric.
      - `multiTurn` boolean, required: Whether this metric was evaluated on a multi-turn conversation.
      - `score` number, nullable: The final metric score.
      - `reason` string, nullable: The reason for the metric score, generated by the evaluation model at evaluation time.
      - `success` boolean, nullable: Whether the metric score is above the threshold.
      - `createdAt` string, date-time, required: The time the metric data was created.
      - `evaluatedAt` string, date-time, nullable: The time the metric was evaluated.
      - `threshold` number, float, required: The threshold for the metric, which determines if the metric is passing or failing.
      - `strictMode` boolean, required: Whether the metric was run in strict mode, which outputs a binary score of 0 or 1.
      - `skipped` boolean, required: Whether the metric evaluation was skipped.
      - `evaluationModel` string, nullable: The evaluation model used to run the evaluation.
      - `error` string, nullable: The error message if the evaluation failed.
      - `evaluationCost` number, float, nullable: The cost of running the evaluation.
      - `verboseLogs` string, nullable: The verbose logs of the evaluation, which breaks down the metric score calculation into individual steps.
    - `totalMetricsData` integer: Total number of metric data entries matching the query
    - `page` integer: Current page number
    - `pageSize` integer: Number of items per page

## Changes

> 54 revisions in range; 3 not diffed.

- **2026-06-02** `78cdf726cfb0`: 2 info
  - api tag `Metrics Data` added
  - api tag `Metric Data` removed
- **2026-06-01** `8ad0916f5777`: 1 info
  - endpoint added
- **2026-06-01** `ce37d847250e`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/changes/v1/metrics-data/get.md)

---

[API](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api.md) - [All operations](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/revisions/95cdde71b65e?raw)