---
title: "List datasets"
method: GET
path: "/beta/dataset"
tags: ["Dataset"]
---

# List datasets

`GET /beta/dataset`

## Request

- Base URL: `https://api.friendli.ai`
- URL: `https://api.friendli.ai/beta/dataset`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/friendli/apis/friendli-suite-api-reference/docs/beta/dataset/get.ts> (a function with typed inputs; its response is checked against the schema)

List datasets accessible to the user.

## Query parameters

- `cursor` string, binary, nullable
- `limit` integer, nullable
- `direction` 'asc' | 'desc', nullable
- `projectId` string, required
- `nameSearch` string, nullable

## Headers

- `X-Friendli-Team` string, nullable: ID of team to run requests as (optional parameter).

## Response `200`

OK

- ListDatasetsResponse: List datasets response.
  - `data` DatasetInfo[], required: List of items.
    - `id` string, required: ID of the dataset.
    - `name` string, required: Name of the dataset.
    - `createdAt` integer, required: Unix timestamp (in seconds) of when the dataset was created.
    - `updatedAt` integer, required: Unix timestamp (in seconds) of when the dataset was last modified.
    - `modality` DedicatedDatasetModality, required: Dataset modality.
      - `input_modals` DedicatedDatasetModalityType[]
      - `output_modals` DedicatedDatasetModalityType[]
  - `nextCursor` string, binary, nullable: Next cursor to use for pagination. `None` indicates no more items to fetch.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/friendli/apis/friendli-suite-api-reference.md) - [All operations](https://skmtc.dev/friendli/apis/friendli-suite-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/friendli/apis/friendli-suite-api-reference/revisions/38fb43993a11?raw)