---
title: "Streaming API v2: Movie, series and episode details"
description: "One movie, one series with its seasons and episodes, and one episode with its series."
---

## `GET vod-info`

Parameter: `id` (required; `400 invalid_parameter` without it). `404
not_found` if there is no such movie in the line's package.

The movie item of `vod-movies` (without `uuid`), plus: `release_date`,
`youtube_trailer`, `director`, `cast`, `description`, `genres`, `backdrops`,
`duration_secs`, `duration` (`HH:MM:SS`), `video` and `audio` (the file's
first video and audio stream as probed, e.g. `{"codec_name": "h264",
"width": 1920, "height": 1080}`; `{}` when the file was not analyzed). Full
example: [`examples/vod-info.json`](/docs/api-v2/examples/vod-info.json).

## `GET series-info`

Parameter: `id` (required). `404 not_found` if there is no such series in
the line's package.

The series item of `series`, plus:

```json
{
  "seasons": [
    { "number": 1, "name": "Season 1", "air_date": "2008-01-20", "episode_count": 7,
      "overview": "…", "rating": 8.5, "poster": "https://img.example.com/bb-s1.jpg" }
  ],
  "episodes": [
    { "id": 5001, "type": "episode", "season": 1, "episode_num": 1, "title": "Pilot",
      "container_extension": "mkv", "added": 978307200, "tmdb_id": 62085,
      "release_date": "2008-01-20", "description": "…", "duration_secs": 3480,
      "duration": "00:58:00", "image": "https://img.example.com/bb-1x1.jpg",
      "video": { "codec_name": "h264", "height": 1080 }, "audio": { "codec_name": "aac" },
      "bitrate": 4500, "rating": 8.9, "is_adult": false }
  ]
}
```

- `episodes` is one list, ordered by season and episode.
- An episode's `id` is what you play (`type=saga`). Its `is_adult` is the
  series'.
- `episode_num` is the episode number the panel imported; when a season has
  no reliable numbering, it is the position within the season.
- `seasons` comes from the metadata provider and may list seasons without
  episodes in the package; group `episodes` by `season` for what is playable.

## `GET episode-info`

Parameter: `id` (the episode `id`). One episode, as in `series-info`, plus
`series_id`, `series_name` and `series_poster`: enough to resume "continue
watching" from a stored episode id. `404 not_found` if it does not exist or
is not in the line's package.