---
title: "List benchmark metrics"
method: GET
path: "/v1/benchmark/metric"
tags: ["Benchmark"]
---

# List benchmark metrics

`GET /v1/benchmark/metric`

## Request

- Base URL: `https://api.roark.ai`
- URL: `https://api.roark.ai/v1/benchmark/metric`
- Auth: HTTP bearer

Returns the metrics a suite version published, each with the direction that counts as better. Use it to pick a valid `sortBy` for the leaderboard: a metric key outside this list is rejected rather than silently ranking every target null.

## Query parameters

- `suite` string, required
- `suiteVersion` string

## Response `200`

Published metrics

- object
  - `data` BenchmarkMetric[], required
    - `metricKey` string, required
    - `metricName` string, required
    - `metricKind` 'NUMERIC' | 'BOOLEAN', required: Which statistics are populated on a result. NUMERIC fills p50/p95/mean/ci; BOOLEAN fills passRate and its interval.
    - `unitSymbol` string, nullable, required
    - `goal` 'higher' | 'lower' | 'neutral', required: Which end of the scale is better. `higher` and `lower` can be ranked; `neutral` is an observational metric that describes a conversation rather than grading it, so sorting on it names no winner.
  - `suite` string, required
  - `suiteVersion` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error

## Changes

> 188 revisions in range; 1 not diffed.

- **2026-09-15** `38989bd64cb3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/benchmark/metric/get.md)

---

[API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) - [All operations](https://skmtc.dev/roarkhq/apis/roark-analytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roarkhq/apis/roark-analytics-api/revisions/efc3377249d1?raw)