---
title: "List distinct metric names in a project"
method: GET
path: "/api/runs/metric-names"
tags: ["Runs"]
---

# List distinct metric names in a project

`GET /api/runs/metric-names`

## Request

- Base URL: `https://pluto-api.trainy.ai`
- URL: `https://pluto-api.trainy.ai/api/runs/metric-names`
- Auth: HTTP bearer

Returns distinct metric names from the pre-computed metric summaries table. Useful for discovering available metrics before querying leaderboard or statistics. Optionally filter by a search substring or specific run IDs.

## Query parameters

- `projectName` string, required: Project name
- `search` string: Substring search to filter metric names (e.g., 'loss')
- `runIds` string: Comma-separated run IDs to scope the search (e.g., '1,2,5')
- `limit` number, nullable: Maximum number of metric names to return (default: 500)

## Response `200`

List of distinct metric names

- ListMetricNamesResponse
  - `projectName` string, required
  - `metricNames` string[], required

---

[API](https://skmtc.dev/trainy/apis/mlop-api.md) - [All operations](https://skmtc.dev/trainy/apis/mlop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trainy/apis/mlop-api/revisions/5d2c0b0baecb?raw)