---
title: "GET /v1/datasource/{uid}/metrics"
method: GET
path: "/v1/datasource/{uid}/metrics"
tags: ["Datasource"]
---

# GET /v1/datasource/{uid}/metrics

`GET /v1/datasource/{uid}/metrics`

## Request

- The document declares no server URL.
- Auth: none declared

ListMetrics returns the list of metric names with basic metadata (name, help, unit, type) for a metrics datasource.

## Path parameters

- `uid` string, required

## Response `200`

OK

- MarksmanApiV1ListMetricsReply
  - `metrics` MarksmanApiV1MetricSummaryItem[]
    - `name` string
    - `help` string
    - `unit` string
    - `type` string

## Changes

- **2026-03-12** `00fc22ea8b5a`: 1 warning, 1 info
  - removed the optional property `metrics/items/description` from the response with the `200` status
  - added the optional property `metrics/items/help` to the response with the `200` status
- **2026-03-09** `e875d8db9cfa`: 2 warning
  - deleted the `query` request parameter `limit`
  - deleted the `query` request parameter `match`
- **2026-03-09** `9c217b052aa9`: 1 info
  - endpoint added
- **2026-02-28** `f5912329bb01`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/changes/v1/datasource/:uid/metrics/get.md)

---

[API](https://skmtc.dev/aide-family/apis/aide-family-marksman-api.md) - [All operations](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/revisions/26ae221fccba?raw)
