---
title: "GET /episodes"
method: GET
path: "/episodes"
tags: ["Episodes"]
---

# GET /episodes

`GET /episodes`

Returns a list of episodes base records with the basic attributes.<br> Note that all episodes are returned, even those that may not be included in a series' default season order.

## Query parameters

- `page` number

## Response `200`

response

- object
  - `data` EpisodeBaseRecord[]
    - `aired` string
    - `airsAfterSeason` integer
    - `airsBeforeEpisode` integer
    - `airsBeforeSeason` integer
    - `finaleType` string — season, midseason, or series
    - `id` integer
    - `image` string
    - `imageType` integer
    - `isMovie` integer
    - `lastUpdated` string
    - `name` string
    - `nameTranslations` string[]
    - `number` integer
    - `overview` string
    - `overviewTranslations` string[]
    - `runtime` integer
    - `seasonNumber` integer
    - `seasons` SeasonBaseRecord[]
      - `id` integer
      - `image` string
      - `imageType` integer
      - `lastUpdated` string
      - `name` string
      - `nameTranslations` string[]
      - `number` integer
      - `overviewTranslations` string[]
      - `companies` Companies — Companies by type record
        - `studio` Company — A company record
          - `activeDate` string
          - `aliases` Alias[]
            - `language` string — A 3-4 character string indicating the language of the alias, as defined in Language.
            - `name` string — A string containing the alias itself.
          - `country` string
          - `id` integer
          - `inactiveDate` string
          - `name` string
          - `nameTranslations` string[]
          - `overviewTranslations` string[]
          - `primaryCompanyType` integer
          - `slug` string
          - `parentCompany` ParentCompany — A parent company record
            - `id` integer
            - `name` string
            - `relation` CompanyRelationShip — A company relationship
              - …
          - `tagOptions` TagOption[]
            - `helpText` string
            - `id` integer
            - `name` string
            - `tag` integer
            - `tagName` string
        - `network` Company — A company record
          - `activeDate` string
          - `aliases` Alias[]
            - `language` string — A 3-4 character string indicating the language of the alias, as defined in Language.
            - `name` string — A string containing the alias itself.
          - `country` string
          - `id` integer
          - `inactiveDate` string
          - `name` string
          - `nameTranslations` string[]
          - `overviewTranslations` string[]
          - `primaryCompanyType` integer
          - `slug` string
          - `parentCompany` ParentCompany — A parent company record
            - `id` integer
            - `name` string
            - `relation` CompanyRelationShip — A company relationship
              - …
          - `tagOptions` TagOption[]
            - `helpText` string
            - `id` integer
            - `name` string
            - `tag` integer
            - `tagName` string
        - `production` Company — A company record
          - `activeDate` string
          - `aliases` Alias[]
            - `language` string — A 3-4 character string indicating the language of the alias, as defined in Language.
            - `name` string — A string containing the alias itself.
          - `country` string
          - `id` integer
          - `inactiveDate` string
          - `name` string
          - `nameTranslations` string[]
          - `overviewTranslations` string[]
          - `primaryCompanyType` integer
          - `slug` string
          - `parentCompany` ParentCompany — A parent company record
            - `id` integer
            - `name` string
            - `relation` CompanyRelationShip — A company relationship
              - …
          - `tagOptions` TagOption[]
            - `helpText` string
            - `id` integer
            - `name` string
            - `tag` integer
            - `tagName` string
        - `distributor` Company — A company record
          - `activeDate` string
          - `aliases` Alias[]
            - `language` string — A 3-4 character string indicating the language of the alias, as defined in Language.
            - `name` string — A string containing the alias itself.
          - `country` string
          - `id` integer
          - `inactiveDate` string
          - `name` string
          - `nameTranslations` string[]
          - `overviewTranslations` string[]
          - `primaryCompanyType` integer
          - `slug` string
          - `parentCompany` ParentCompany — A parent company record
            - `id` integer
            - `name` string
            - `relation` CompanyRelationShip — A company relationship
              - …
          - `tagOptions` TagOption[]
            - `helpText` string
            - `id` integer
            - `name` string
            - `tag` integer
            - `tagName` string
        - `special_effects` Company — A company record
          - `activeDate` string
          - `aliases` Alias[]
            - `language` string — A 3-4 character string indicating the language of the alias, as defined in Language.
            - `name` string — A string containing the alias itself.
          - `country` string
          - `id` integer
          - `inactiveDate` string
          - `name` string
          - `nameTranslations` string[]
          - `overviewTranslations` string[]
          - `primaryCompanyType` integer
          - `slug` string
          - `parentCompany` ParentCompany — A parent company record
            - `id` integer
            - `name` string
            - `relation` CompanyRelationShip — A company relationship
              - …
          - `tagOptions` TagOption[]
            - `helpText` string
            - `id` integer
            - `name` string
            - `tag` integer
            - `tagName` string
      - `seriesId` integer
      - `type` SeasonType — season type record
        - `alternateName` string
        - `id` integer
        - `name` string
        - `type` string
      - `year` string
    - `seriesId` integer
    - `seasonName` string
    - `year` string
  - `status` string
  - `links` Links — Links for next, previous and current record
    - `prev` string
    - `self` string
    - `next` string
    - `total_items` integer
    - `page_size` integer

## Other responses

- `401` — Unauthorized

## Changes

- **2022-08-09** `499c304033fa` — 2 info
  - added the optional property `data/items/seasons/items/year` to the response with the `200` status
  - added the optional property `data/items/year` to the response with the `200` status
- **2022-08-09** `925b928e7ab9` — 2 warning
  - removed the optional property `data/items/seasons/items/year` from the response with the `200` status
  - removed the optional property `data/items/year` from the response with the `200` status
- **2022-08-09** `fa722c514523` — 2 info
  - added the optional property `data/items/seasons/items/year` to the response with the `200` status
  - added the optional property `data/items/year` to the response with the `200` status
- **2022-07-12** `7cfc67e90b13` — 1 info
  - added the optional property `data/items/seasons/items/lastUpdated` to the response with the `200` status
- **2022-06-25** `4626b0079a8b` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/thetvdb/apis/tvdb-api-v4/changes/episodes/get.md)

---

[API](https://skmtc.dev/thetvdb/apis/tvdb-api-v4.md) · [All operations](https://skmtc.dev/thetvdb/apis/tvdb-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thetvdb/tvdb-api-v4/revisions/04eb4ddf68c8/schema)