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

# List log facets

`GET /v3/logs/facets`

Return the facet hierarchy: attribute families (native, attribute, resource, scope) with their keys, counts, and top values for the requested time range.

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `key_limit` integer
- `value_limit` integer

## 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

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/f54fa34db0f4/schema)