---
title: "List telemetry facet values"
method: POST
path: "/v3/telemetry/facet-values"
tags: ["Telemetry"]
---

# List telemetry facet values

`POST /v3/telemetry/facet-values`

Lists caller-scoped values for one source, metric, and field while applying sibling structured filters. Reporting metrics use metric-aware rollups; raw trace metrics preserve trace facet semantics.

## Request body

- ListTelemetryFacetValuesRequest
  - `source` 'TELEMETRY_SOURCE_UNSPECIFIED' | 'TELEMETRY_SOURCE_TRACES' | 'TELEMETRY_SOURCE_METRICS' | 'TELEMETRY_SOURCE_LOGS'
  - `metric` string
  - `field` string
  - `from` string, date-time
  - `to` string, date-time
  - `filters` TraceFilter[]
    - `field` string
    - `op` string
    - `values` string[]
  - `filter_operator` string
  - `limit` integer

## Response `200`

OK

- ListTelemetryFacetValuesResponse
  - `field` string
  - `values` TraceFacetValue[]
    - `value` string
    - `count` integer
  - `has_more` boolean

## Changes

> 350 revisions in range; 136 not diffed.

- **2026-09-28** `3c7d859558ee` — 1 info
  - endpoint added
- **2026-09-21** `8f82880fa08a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v3/telemetry/facet-values/post.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/orq-ai/apis/orq-ai-api/revisions/3c7d859558ee?raw)