---
title: "Check if a dataset is valid"
method: GET
path: "/is-valid"
---

# Check if a dataset is valid

`GET /is-valid`

Returns the capabilities of the dataset: show a preview of the 100 first rows, show the viewer for all the rows, search/filter the rows, have statistics. Use the optional config and split parameters to filter the response.

## Query parameters

- `dataset` string, required
- `config` string
- `split` string

## Response `200`

The capabilities of the dataset.

- IsValidResponse
  - `viewer` boolean, required
  - `preview` boolean, required
  - `search` boolean, required
  - `filter` boolean, required
  - `statistics` boolean, required

## Other responses

- `401` — If the external authentication step on the Hugging Face Hub failed, and no authentication mechanism has been provided. Retry with authentication.
- `404` — If the repository to download from cannot be found. This may be because it doesn't exist, or because it is set to `private` and you do not have access.
- `422` — The 'dataset' parameter has not been provided or is invalid.
- `500` — The server crashed.

## Changes

- **2024-03-14** `0a7885479f64` — 1 info
  - the response property `statistics` became required for the status `200`
- **2024-03-13** `e434b1d7684a` — 1 info
  - the endpoint scheme security `CookieHuggingFace` was removed from the API
- **2024-03-12** `106342b22cd2` — 1 info
  - added the optional property `statistics` to the response with the `200` status
- **2024-01-08** `7197f9e24c08` — 1 info
  - added the required property `filter` to the response with the `200` status

[Change history](https://skmtc.dev/huggingface/apis/dataset-viewer-server-api/changes/is-valid/get.md)

---

[API](https://skmtc.dev/huggingface/apis/dataset-viewer-server-api.md) · [All operations](https://skmtc.dev/huggingface/apis/dataset-viewer-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/huggingface/dataset-viewer-server-api/revisions/5048b8c0f4f9/schema)