---
title: "List attribute values"
method: GET
path: "/internal/v1/metrics/{project_id}/attributes/{attr_key}"
tags: ["Metrics"]
---

# List attribute values

`GET /internal/v1/metrics/{project_id}/attributes/{attr_key}`

List values for a specific metric attribute key. Returns distinct attribute values with their occurrence count. Use the search parameter to filter by metric name.

## Path parameters

- `project_id` integer, required
- `attr_key` string, required

## Query parameters

- `time_start` string, date-time, required — RFC3339 timestamp.
- `time_end` string, date-time, required — RFC3339 timestamp.
- `search` string

## Response `200`

Attribute values list.

- ListMetricAttributeValuesResponse
  - `items` MetricAttributeValue[], required
    - `value` string, required — Attribute value.
    - `count` integer, required — Occurrence count.
  - `hasMore` boolean, required

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions

---

[API](https://skmtc.dev/uptrace/apis/uptrace-json-api.md) · [All operations](https://skmtc.dev/uptrace/apis/uptrace-json-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptrace/apis/uptrace-json-api/revisions/550c8881ab9a?raw)