---
title: "Get a dataset"
method: GET
path: "/dataset/{dataset_id}"
tags: ["Datasets"]
---

# Get a dataset

`GET /dataset/{dataset_id}`

## Request

- Base URL: `https://api.indexone.io`
- URL: `https://api.indexone.io/dataset/{dataset_id}`
- Auth: API key in header `x-api-key` and API key in header `Authorization`

Returns the dataset record. With `parsed=true` the current parquet file is read from S3 and its rows are attached as `data` — convenient for previews, but it loads the whole dataset into the response, so avoid it for large files.

Note there is no ownership check on this route: any authenticated caller who knows a `dst_...` id can read it.

## Path parameters

- `dataset_id` string, required

## Query parameters

- `parsed` boolean

## Response `200`

The dataset record.

- object

## Other responses

- `401`: Missing or invalid id token.
- `403`: Missing or invalid `x-api-key`.
- `404`: No such dataset. The handler indexes the DynamoDB `Item` key unguarded, so an unknown id surfaces as a `500`-class gateway error rather than a clean 404.
- `429`: API key usage-plan rate limit exceeded.

---

[API](https://skmtc.dev/indexone/apis/index-one-rest-api.md) · [All operations](https://skmtc.dev/indexone/apis/index-one-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/indexone/apis/index-one-rest-api/revisions/df5a92216a9c?raw)