---
title: "Get Episode"
method: GET
path: "/v0/episodes/{episode_id}"
tags: ["章节"]
---

# Get Episode

`GET /v0/episodes/{episode_id}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

## Path parameters

- `episode_id` integer, required: 剧集 ID

## Response `200`

Successful Response

- EpisodeDetail
  - `id` integer, required
  - `type` 0 | 1 | 2 | 3 | 4 | 5 | 6, required: 本篇 = 0 特别篇 = 1 OP = 2 ED = 3 预告/宣传/广告 = 4 MAD = 5 其他 = 6
  - `name` string, required
  - `name_cn` string, required
  - `sort` number, required: 同类条目的排序和集数
  - `ep` number: 条目内的集数, 从`1`开始。非本篇剧集的此字段无意义
  - `airdate` string, required
  - `comment` integer, required
  - `duration` string, required
  - `desc` string, required: 简介
  - `disc` integer, required: 音乐曲目的碟片数
  - `subject_id` integer, required

## Other responses

- `400`: Validation Error
- `404`: Not Found

## Changes

- **2024-10-01** (v0) `25167996e069`: 7 warning
  - added the new `0.00` enum value to the `type` response property for the response status `200`
  - added the new `1.00` enum value to the `type` response property for the response status `200`
  - added the new `2.00` enum value to the `type` response property for the response status `200`
  - added the new `3.00` enum value to the `type` response property for the response status `200`
  - …3 more
- **2022-11-19** (v0) `bb6bcec42206`: 2 warning, 2 info
  - removed the optional property `detail` from the response with the `400` status
  - removed the optional property `detail` from the response with the `404` status
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `404` status
- **2022-06-21** (v0) `849933a48cb4`: 1 warning
  - for the `path` request parameter `episode_id`, the min was set to `1.00`
- **2022-05-07** (v0) `588c3a75d5cd`: 4 breaking, 4 warning
  - added `subschema #1, subschema #2` to the `detail` response property `oneOf` list for the response status `400`
  - added `subschema #1, subschema #2` to the `detail` response property `oneOf` list for the response status `404`
  - the `detail` response's property type changed from `object` to no type for status `400`
  - the `detail` response's property type changed from `object` to no type for status `404`
  - …4 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/bangumi/apis/bangumi-open-api/changes/v0/episodes/:episode_id/get.md)

---

[API](https://skmtc.dev/bangumi/apis/bangumi-open-api.md) - [All operations](https://skmtc.dev/bangumi/apis/bangumi-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bangumi/apis/bangumi-open-api/revisions/6aafdbda7895?raw)