---
title: "Read Datasets"
method: GET
path: "/api/v1/datasets"
tags: ["datasets"]
---

# Read Datasets

`GET /api/v1/datasets`

Get all datasets by query params and owner.

## Query parameters

- `id` string[], nullable
- `data_type` union
  - DataType[]
  - 'kv' | 'llm' | 'chat' — Enum for dataset data types.
- `name` string, nullable
- `name_contains` string, nullable
- `metadata` string, nullable
- `offset` integer
- `limit` integer
- `sort_by` 'name' | 'created_at' | 'last_session_start_time' | 'example_count' | 'session_count' | 'modified_at' — Enum for available dataset columns to sort by.
- `sort_by_desc` boolean
- `tag_value_id` string[], nullable
- `exclude_corrections_datasets` boolean
- `exclude` GetDatasetsSelect[], nullable

## Response `200`

Successful Response

- Dataset[]
  - `name` string, required
  - `description` string, nullable
  - `created_at` string, date-time
  - `inputs_schema_definition` object, nullable
  - `outputs_schema_definition` object, nullable
  - `externally_managed` boolean, nullable
  - `transformations` DatasetTransformation[], nullable
    - `path` string[], required
    - `transformation_type` 'convert_to_openai_message' | 'convert_to_openai_tool' | 'remove_system_messages' | 'remove_extra_fields' | 'extract_tools_from_run', required — Enum for dataset transformation types. Ordering determines the order in which transformations are applied if there are multiple transformations on the same path.
  - `data_type` 'kv' | 'llm' | 'chat' — Enum for dataset data types.
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `example_count` integer, nullable
  - `session_count` integer, required
  - `modified_at` string, date-time, required
  - `last_session_start_time` string, date-time, nullable
  - `metadata` object, nullable
  - `baseline_experiment_id` string, uuid, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/versions/a0acb3a6a101/schema)