---
title: "Read Shared Dataset"
method: GET
path: "/api/v1/public/{share_token}/datasets"
tags: ["public"]
---

# Read Shared Dataset

`GET /api/v1/public/{share_token}/datasets`

Get dataset by ids or the shared dataset if not specifed.

## Path parameters

- `share_token` string, uuid, required

## Query parameters

- `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

## Response `200`

Successful Response

- DatasetPublicSchema — Public schema for datasets. Doesn't currently include session counts/stats since public test project sharing is not yet shipped
  - `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
  - `example_count` integer, required

## 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/revisions/a0acb3a6a101/schema)