---
title: "List log facets"
method: POST
path: "/v3/logs/facets"
tags: ["Logs"]
---

# List log facets

`POST /v3/logs/facets`

Return the facet hierarchy: attribute families (native, attribute, resource, scope) with their keys, counts, and top values. Accepts optional filters and free-text query to narrow the counted subset.

## Request body

- ListLogFacetsRequest
  - `from` string, date-time
  - `to` string, date-time
  - `key_limit` integer
  - `value_limit` integer
  - `query` string
  - `filter_operator` string
  - `filters` TraceFilter[]
    - `field` string
    - `op` string
    - `values` string[]

## Response `200`

OK

- ListLogFacetsResponse
  - `groups` FacetGroup[]
    - `name` string
    - `keys` FacetKey[]
      - `key` string
      - `field` string
      - `log_count` string
      - `distinct_value_count` string
      - `top_values` FacetValue[]
        - `value` string
        - `count` string
      - `filterable` boolean

## Changes

> 350 revisions in range; 136 not diffed.

- **2026-09-07** `bcd6172f8655` — 1 info
  - endpoint added
- **2026-09-07** `dcc0afb98a48` — 1 breaking
  - api removed without deprecation
- **2026-09-06** `e1a2869bc12f` — 1 info
  - endpoint added
- **2026-09-06** `28c58af69b8c` — 1 breaking
  - api removed without deprecation
- **2026-09-04** `bd22332086ec` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v3/logs/facets/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)