---
title: "GET /seasons"
method: GET
path: "/seasons"
tags: ["Seasons"]
---

# GET /seasons

`GET /seasons`

returns list of seasons base records

## Query parameters

- `page` number

## Response `200`

response

- object
  - `data` 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
            - `id` integer
            - `typeName` string
        - `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
            - `id` integer
            - `typeName` string
        - `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
            - `id` integer
            - `typeName` string
        - `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
            - `id` integer
            - `typeName` string
        - `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
            - `id` integer
            - `typeName` string
        - `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
  - `status` string

## Other responses

- `401` — Unauthorized

## Changes

- **2022-08-09** `499c304033fa` — 1 info
  - added the optional property `data/items/year` to the response with the `200` status
- **2022-08-09** `925b928e7ab9` — 1 warning
  - removed the optional property `data/items/year` from the response with the `200` status
- **2022-08-09** `fa722c514523` — 1 info
  - 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/lastUpdated` to the response with the `200` status
- **2022-06-22** `66dc70fad7cb` — 1 warning
  - removed the optional property `data/items/lastUpdated` from the response with the `200` status

[Full history](https://skmtc.dev/thetvdb/apis/tvdb-api-v4/changes/seasons/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.dev/thetvdb/apis/tvdb-api-v4/revisions/bed301c04f13?raw)