---
title: "List Metrics"
method: GET
path: "/projects/{projectId}/metrics"
---

# List Metrics

`GET /projects/{projectId}/metrics`

List Metrics configured for the specified Project. Metrics are returned in reverse chronological order.

## Path parameters

- `projectId` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Successfully retrieved Metrics.

- object
  - `data` Metric[], required
    - union — A Metric defines how to evaluate system outputs against expected results.
      - object — A Metric with AI evaluation and integer output.
        - `id` string, required — The ID of the Metric.
        - `name` string, required — The name of the Metric.
        - `description` string, nullable, required — The description of the Metric.
        - `evalType` 'ai', required — AI-based evaluation type.
        - `guidelines` string, required — Guidelines for AI evaluation on how to score the metric.
        - `promptTemplate` string, required — The complete prompt template for AI evaluation. Should include placeholders for dynamic content.
        - `evalModelName` string, required — The AI model to use for evaluation.
        - `temperature` number — The temperature for AI evaluation (0-2). Omit to use the model provider's default.
        - `outputType` 'int', required — Integer output type.
        - `passingThreshold` integer, required — The threshold for determining pass/fail from integer scores (1-5).
      - object — A Metric with human evaluation and integer output.
        - `id` string, required — The ID of the Metric.
        - `name` string, required — The name of the Metric.
        - `description` string, nullable, required — The description of the Metric.
        - `evalType` 'human', required — Human-based evaluation type.
        - `guidelines` string, required — Guidelines for human evaluators.
        - `outputType` 'int', required — Integer output type.
        - `passingThreshold` integer, required — The threshold for determining pass/fail from integer scores (1-5).
      - object — A Metric with heuristic evaluation and integer output.
        - `id` string, required — The ID of the Metric.
        - `name` string, required — The name of the Metric.
        - `description` string, nullable, required — The description of the Metric.
        - `evalType` 'heuristic', required — Heuristic-based evaluation type.
        - `guidelines` string, required — Guidelines for heuristic evaluation logic.
        - `outputType` 'int', required — Integer output type.
        - `passingThreshold` integer, required — The threshold for determining pass/fail from integer scores (1-5).
      - object — A Metric with AI evaluation and float output.
        - `id` string, required — The ID of the Metric.
        - `name` string, required — The name of the Metric.
        - `description` string, nullable, required — The description of the Metric.
        - `evalType` 'ai', required — AI-based evaluation type.
        - `guidelines` string, required — Guidelines for AI evaluation on how to score the metric.
        - `promptTemplate` string, required — The complete prompt template for AI evaluation. Should include placeholders for dynamic content.
        - `evalModelName` string, required — The AI model to use for evaluation.
        - `temperature` number — The temperature for AI evaluation (0-2). Omit to use the model provider's default.
        - `outputType` 'float', required — Float output type (0-1).
        - `passingThreshold` number, required — Threshold for determining pass/fail from float scores (0.0-1.0).
      - object — A Metric with human evaluation and float output.
        - `id` string, required — The ID of the Metric.
        - `name` string, required — The name of the Metric.
        - `description` string, nullable, required — The description of the Metric.
        - `evalType` 'human', required — Human-based evaluation type.
        - `guidelines` string, required — Guidelines for human evaluators.
        - `outputType` 'float', required — Float output type (0-1).
        - `passingThreshold` number, required — Threshold for determining pass/fail from float scores (0.0-1.0).
      - object — A Metric with heuristic evaluation and float output.
        - `id` string, required — The ID of the Metric.
        - `name` string, required — The name of the Metric.
        - `description` string, nullable, required — The description of the Metric.
        - `evalType` 'heuristic', required — Heuristic-based evaluation type.
        - `guidelines` string, required — Guidelines for heuristic evaluation logic.
        - `outputType` 'float', required — Float output type (0-1).
        - `passingThreshold` number, required — Threshold for determining pass/fail from float scores (0.0-1.0).
      - object — A Metric with AI evaluation and boolean output.
        - `id` string, required — The ID of the Metric.
        - `name` string, required — The name of the Metric.
        - `description` string, nullable, required — The description of the Metric.
        - `evalType` 'ai', required — AI-based evaluation type.
        - `guidelines` string, required — Guidelines for AI evaluation on how to score the metric.
        - `promptTemplate` string, required — The complete prompt template for AI evaluation. Should include placeholders for dynamic content.
        - `evalModelName` string, required — The AI model to use for evaluation.
        - `temperature` number — The temperature for AI evaluation (0-2). Omit to use the model provider's default.
        - `outputType` 'boolean', required — Boolean output type.
      - object — A Metric with human evaluation and boolean output.
        - `id` string, required — The ID of the Metric.
        - `name` string, required — The name of the Metric.
        - `description` string, nullable, required — The description of the Metric.
        - `evalType` 'human', required — Human-based evaluation type.
        - `guidelines` string, required — Guidelines for human evaluators.
        - `outputType` 'boolean', required — Boolean output type.
      - object — A Metric with heuristic evaluation and boolean output.
        - `id` string, required — The ID of the Metric.
        - `name` string, required — The name of the Metric.
        - `description` string, nullable, required — The description of the Metric.
        - `evalType` 'heuristic', required — Heuristic-based evaluation type.
        - `guidelines` string, required — Guidelines for heuristic evaluation logic.
        - `outputType` 'boolean', required — Boolean output type.
  - `nextCursor` string, nullable, required
  - `hasMore` boolean, required
  - `total` integer

## Other responses

- `401` — Error indicating that the request is not authenticated.
- `500` — An internal service error indicating an issue with the Scorecard service.

## Changes

- **2026-08-10** `121aaa257802` — 3 breaking, 3 info
  - the response property `data/items/anyOf[subschema #1: AI int metric]/temperature` became optional for the status `200`
  - the response property `data/items/anyOf[subschema #4: AI float metric]/temperature` became optional for the status `200`
  - the response property `data/items/anyOf[subschema #7: AI boolean metric]/temperature` became optional for the status `200`
  - the `temperature` response's property default value `0` was removed for the status `200`
  - …2 more
- **2025-10-08** `e3c98e8dd7fa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/scorecard-ai/apis/scorecard-api/changes/projects/:projectId/metrics/get.md)

---

[API](https://skmtc.dev/scorecard-ai/apis/scorecard-api.md) · [All operations](https://skmtc.dev/scorecard-ai/apis/scorecard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scorecard-ai/scorecard-api/revisions/121aaa257802/schema)