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

# List dataset facets

`GET /catalog/datasets/{dataset_id}/facets`

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

## Other responses

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

---

[API](https://skmtc.dev/opendatasoft/apis/explore-api.md) · [All operations](https://skmtc.dev/opendatasoft/apis/explore-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opendatasoft/explore-api/revisions/8c5a10310454/schema)