---
title: "List dataset facets"
method: GET
path: "/catalog/datasets/timeseries/facets"
tags: ["Dataset"]
---

# List dataset facets

`GET /catalog/datasets/timeseries/facets`

## Request

- Base URL: `https://mannheim.huwise.com/api/explore/v2.1`
- URL: `https://mannheim.huwise.com/api/explore/v2.1/catalog/datasets/timeseries/facets`
- Auth: API key in query parameter `apikey`

Enumerates facet values for records and returns a list of values for each facet.
Can be used to implement guided navigation in large result sets.

## Path parameters

- `dataset_id` string, required

## Query parameters

- `where` string
- `refine` string
- `exclude` string
- `facet` string
- `lang` 'en' | 'fr' | 'nl' | 'pt' | 'it' | 'ar' | 'de' | 'es' | 'ca' | 'eu' | 'sv'
- `timezone` string

## Response `200`

Facets enumeration

- object
  - `links` Links[]
    - `href` string, uri
    - `rel` 'self' | 'first' | 'last' | 'next' | 'dataset' | 'catalog'
  - `facets` FacetEnumeration[]
    - `name` string
    - `facets` FacetValueEnumeration[]
      - `name` string
      - `count` integer
      - `value` string
      - `state` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `429`: Too many requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/huwise/apis/explore-api.md) - [All operations](https://skmtc.dev/huwise/apis/explore-api/llms.txt) - [OpenAPI document](https://skmtc.dev/huwise/apis/explore-api/revisions/7009ed702c9d?raw)