---
title: "Search Episodes"
method: GET
path: "/datasets/{dataset_id}/episodes"
tags: ["review"]
---

# Search Episodes

`GET /datasets/{dataset_id}/episodes`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/datasets/{dataset_id}/episodes`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `dataset_id` string, uuid, required

## Query parameters

- `version` integer, nullable
- `task` string, nullable
- `site` string, nullable
- `robot` string, nullable
- `operator` string, nullable
- `outcome` 'success' | 'failure' | 'incomplete' | 'unknown', nullable
- `failure_stage` string, nullable
- `min_interventions` integer, nullable
- `quality_min` number, nullable
- `quality_max` number, nullable
- `tag` string, nullable
- `episode_id` string, nullable
- `limit` integer
- `after` string, nullable

## Response `200`

Successful Response

- SearchOut
  - `dataset_id` string, uuid, required
  - `episodes` Episode[], required
    - `version` integer, required
    - `episode_index` integer, required
    - `episode_id` string, nullable, required
    - `tasks` string[], required
    - `site` string, required
    - `robot` string, required
    - `operator` string, required
    - `length` integer, required
    - `interventions` integer, required
    - `quality_score` number, nullable, required
    - `curation_drop` string, nullable, required
    - `outcome` string, required
    - `failure_stage` string, nullable, required
    - `pages` integer, required
    - `subtasks` object[], nullable, required
    - `failure_tags` string[], nullable, required
  - `next_after` string, nullable, required
  - `facets` Facets, required
    - `versions` integer[], required
    - `tasks` string[], required
    - `sites` string[], required
    - `robots` string[], required
    - `operators` string[], required
    - `outcomes` string[], required
    - `failure_stages` string[], required
    - `tags` string[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/os3robotics/apis/os3-api.md) - [All operations](https://skmtc.dev/os3robotics/apis/os3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/os3robotics/apis/os3-api/revisions/af32cd4f14bb?raw)