---
title: "Read Grouped Experiments"
method: POST
path: "/api/v1/datasets/{dataset_id}/experiments/grouped"
tags: ["datasets"]
---

# Read Grouped Experiments

`POST /api/v1/datasets/{dataset_id}/experiments/grouped`

Stream grouped and aggregated experiments.

## Path parameters

- `dataset_id` string, uuid, required

## Request body

- GroupedExperimentsRequest — Schema for grouped experiment (tracer session) query.
  - `stats_start_time` string, date-time, nullable
  - `name_contains` string, nullable
  - `tag_value_id` string[], nullable
  - `dataset_version` string, nullable
  - `filter` string, nullable
  - `use_approx_stats` boolean
  - `metadata_keys` string[], required
  - `experiment_limit` integer

## Response `200`

Successful Response

- unknown

## 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)