---
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[]
    - `absoluteNumber` integer
    - `aired` string
    - `airsAfterSeason` integer
    - `airsBeforeEpisode` integer
    - `airsBeforeSeason` integer
    - `finaleType` string — season, midseason, or series
    - `id` integer
    - `image` string
    - `imageType` integer, nullable
    - `isMovie` integer
    - `lastUpdated` string
    - `linkedMovie` integer
    - `name` string
    - `nameTranslations` string[]
    - `number` integer
    - `overview` string
    - `overviewTranslations` string[]
    - `runtime` integer, nullable
    - `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[]
          - `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, nullable
          - `slug` string
          - `parentCompany` ParentCompany — A parent company record
            - `id` integer, nullable
            - `name` string
            - `relation` CompanyRelationShip — A company relationship
              - …
          - `tagOptions` TagOption[]
            - `helpText` string
            - `id` integer
            - `name` string
            - `tag` integer
            - `tagName` string
        - `network` Company[]
          - `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, nullable
          - `slug` string
          - `parentCompany` ParentCompany — A parent company record
            - `id` integer, nullable
            - `name` string
            - `relation` CompanyRelationShip — A company relationship
              - …
          - `tagOptions` TagOption[]
            - `helpText` string
            - `id` integer
            - `name` string
            - `tag` integer
            - `tagName` string
        - `production` Company[]
          - `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, nullable
          - `slug` string
          - `parentCompany` ParentCompany — A parent company record
            - `id` integer, nullable
            - `name` string
            - `relation` CompanyRelationShip — A company relationship
              - …
          - `tagOptions` TagOption[]
            - `helpText` string
            - `id` integer
            - `name` string
            - `tag` integer
            - `tagName` string
        - `distributor` Company[]
          - `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, nullable
          - `slug` string
          - `parentCompany` ParentCompany — A parent company record
            - `id` integer, nullable
            - `name` string
            - `relation` CompanyRelationShip — A company relationship
              - …
          - `tagOptions` TagOption[]
            - `helpText` string
            - `id` integer
            - `name` string
            - `tag` integer
            - `tagName` string
        - `special_effects` Company[]
          - `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, nullable
          - `slug` string
          - `parentCompany` ParentCompany — A parent company record
            - `id` integer, nullable
            - `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, nullable
    - `self` string, nullable
    - `next` string
    - `total_items` integer
    - `page_size` integer

## Other responses

- `401` — Unauthorized

## Changes

- **2026-07-17** `5d7caa274c72` — 2 breaking
  - the response property `links/prev` became nullable for the status `200`
  - the response property `links/self` became nullable for the status `200`
- **2024-04-27** `47f34dd2fd7e` — 1 info
  - added the optional property `data/items/absoluteNumber` to the response with the `200` status
- **2024-03-24** `f825d3005872` — 5 breaking
  - the response property `data/items/seasons/items/companies/distributor/items/primaryCompanyType` became nullable for the status `200`
  - the response property `data/items/seasons/items/companies/network/items/primaryCompanyType` became nullable for the status `200`
  - the response property `data/items/seasons/items/companies/production/items/primaryCompanyType` became nullable for the status `200`
  - the response property `data/items/seasons/items/companies/special_effects/items/primaryCompanyType` became nullable for the status `200`
  - …1 more
- **2024-02-08** `8cb67a07c134` — 2 breaking, 60 warning
  - the response property `data/items/imageType` became nullable for the status `200`
  - the response property `data/items/runtime` became nullable for the status `200`
  - removed the optional property `data/items/seasons/items/companies/distributor/activeDate` from the response with the `200` status
  - removed the optional property `data/items/seasons/items/companies/distributor/aliases` from the response with the `200` status
  - …58 more
- …earlier changes not shown

[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/5d7caa274c72/schema)