---
title: "First rows of a split"
method: GET
path: "/first-rows"
---

# First rows of a split

`GET /first-rows`

The list of the 100 first rows of a dataset split.

## Query parameters

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

## Response `200`

The <a href='https://huggingface.co/docs/datasets/about_dataset_features'>features</a>, and the 100 first rows of the split.</br>Note: the response can be truncated (less rows, or truncated cell contents): see examples.

- FirstRowsResponse
  - `dataset` string, required
  - `config` string, required
  - `split` string, required
  - `features` FeatureItem[], required
    - `feature_idx` integer, required
    - `name` string, required
    - `type` union, required
      - ValueFeature
        - `_type` 'Value', required
        - `dtype` 'null' | 'bool' | 'int8' | 'int16' | 'int32' | 'int64' | 'uint8' | 'uint16' | 'uint32' | 'uint64' | 'float16' | 'float32 (alias float)' | 'float64 (alias double)' | 'time32[(s|ms)]' | 'time64[(us|ns)]' | 'timestamp[(s|ms|us|ns)]' | 'timestamp[(s|ms|us|ns), tz=(tzstring)]' | 'date32' | 'date64' | 'duration[(s|ms|us|ns)]' | 'decimal128(precision, scale)' | 'decimal256(precision, scale)' | 'binary' | 'large_binary' | 'string' | 'large_string', required
      - ClassLabelFeature
        - `_type` 'ClassLabel', required
        - `names` string[], required
      - ArrayXDFeature
        - `_type` 'Array2D' | 'Array3D' | 'Array4D' | 'Array5D', required
        - `shape` integer[], required
      - TranslationFeature
        - `_type` 'Translation', required
        - `languages` string[], required
      - TranslationVariableLanguagesFeature
        - `_type` 'TranslationVariableLanguages', required
        - `num_languages` integer
        - `languages` string[], required
      - JsonFeature
        - `_type` 'Json', required
        - `decode` boolean
      - SequenceFeature
        - `_type` 'Sequence', required
        - `length` integer
        - `feature` Feature, required — recursive
      - LargeListFeature
        - `_type` 'LargeList', required
        - `feature` Feature, required — recursive
      - DictFeature
      - ListFeature
        - `_type` 'List', required
        - `feature` Feature, required — recursive
      - Feature[]
      - AudioFeature
        - `_type` 'Audio', required
        - `sampling_rate` number, required
        - `mono` boolean
        - `decode` boolean
      - ImageFeature
        - `_type` 'Image', required
        - `decode` boolean
      - VideoFeature
        - `_type` 'Video', required
        - `decode` boolean
      - PdfFeature
        - `_type` 'Pdf', required
        - `decode` boolean
  - `rows` RowItem[], required
    - `row_idx` integer, required
    - `row` object, required
    - `truncated_cells` string[], required
  - `truncated` 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, or if the config or split does not exist in the dataset. Note that this may be because the dataset doesn't exist, or because it is set to `private` and you do not have access.
- `422` — Some of the 'dataset', 'config' or 'split' parameters have not been provided or are 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)