---
title: "List of parquet files"
method: GET
path: "/parquet"
---

# List of parquet files

`GET /parquet`

The dataset is converted to the parquet format. The endpoint gives the list of the parquet files. The same split can have multiple parquet files, called shards. They are sorted by their shard index.

## Query parameters

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

## Response `200`

A list of parquet files.</br>Beware: the response is not paginated.

- ParquetResponse
  - `parquet_files` SplitHubFile[], required
    - `dataset` string, required
    - `config` string, required
    - `split` string, required
    - `url` string, uri, required
    - `filename` string, required
    - `size` integer, required
  - `features` object
  - `pending` Job[]
    - `dataset` string, required
    - `kind` string, required
    - `config` string, required
    - `split` string, nullable, required
  - `failed` Job[]
    - `dataset` string, required
    - `kind` string, required
    - `config` string, required
    - `split` string, nullable, required
  - `partial` boolean, required — True means that the response has been computed on part of the dataset (typically the first 5GB). False means that the complete dataset was used.

## 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, the response still hasn't been generated (the process is asynchronous), or the response couldn't be generated successfully due to an error in the dataset itself. The client can retry after a time, in particular in the case of the response still being processed. If the error does not vanish, it's possibly due to a bug in the API software or in the dataset, and should be reported.
- `501` — The server does not implement the feature.

---

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