---
title: "A slice of rows of a split"
method: GET
path: "/rows"
---

# A slice of rows of a split

`GET /rows`

The list of rows of a dataset split at a given slice location (offset). Up to 100 rows are returned, use the length parameter to get less.

## Query parameters

- `dataset` string, required
- `config` string, required
- `split` string, required
- `offset` integer
- `length` integer

## Response `200`

The <a href='https://huggingface.co/docs/datasets/about_dataset_features'>features</a>, and the list of rows of the requested slice. Bytes columns are not supported at the moment, and their content will be 'null'.

- PaginatedResponse
  - `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
  - `num_rows_total` integer, required
  - `num_rows_per_page` integer, required
  - `partial` 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', 'split', 'offset' or 'length' parameters have not been provided or are invalid.
- `500` — The server crashed, or the response couldn't be generated successfully due to an error in the dataset itself. 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)