---
title: "Season Metadata"
method: GET
path: "/svm/tv_shows/{id}/seasons/{season}"
tags: ["TV Shows"]
---

# Season Metadata

`GET /svm/tv_shows/{id}/seasons/{season}`

## Request

- Base URL: `https://api.luminatedata.com`
- URL: `https://api.luminatedata.com/svm/tv_shows/{id}/seasons/{season}`
- Auth: API key in header `x-api-key` and API key in header `authorization`

Retrieves metadata for a season of a TV show

## Path parameters

- `id` string, required
- `season` string, required

## Response `200`

OK

- SuccessfulResponseSeasonMetadata
  - `data` SeasonMetadata
    - `id` string: Unique Luminate ID assigned to the TV show
    - `title` string: Title of the season: the season’s own marketed name where it has one, otherwise the title of the TV show
    - `season` string: ID of the TV show’s season
    - `overview` string: Short description of the season
    - `runtime` integer: Runtime of the season in minutes
    - `release_information` ReleaseDate[]: Release information about the season
      - `release_date` string, date: Date the item was first available to stream formatted according to the ISO 8601 date standard (YYYY-MM-DD)
    - `episodes` string[]: List of IDs of the season’s episodes
    - `genres` string[]: List of genres assigned to the TV show
    - `studios` string[]: List of studios involved in the production of the TV show
    - `platform_availability` string[]: Platforms where the season can be viewed
    - `original` boolean: Indicates whether the title is an original production for a platform
    - `original_platform` string: The platform for which this is an original production. Null if the title is not an original.
    - `creators` string[]: Creators/showrunners behind the season
    - `country_of_origin` string[]: Countries of origin of the season as ISO 3166-1 alpha-2 codes
    - `original_language` string[]: Original languages of the season as lowercase two-letter ISO 639-1 language codes (e.g., ['en', 'fr']). Languages without a two-letter code use a three-letter ISO 639-2/639-3 code (e.g., 'yue' for Cantonese, 'zxx' for no dialogue).
    - `seasons` string[]: List of IDs of the TV show’s seasons
    - `external_ids` ExternalIds: External identifiers for the talent, such as the IMDb name ID
      - `imdb` string[]: IMDB ID
      - `lftv` string[]: Luminate Film & TV project ID

## Other responses

- `400`: Issue with client request
- `404`: Series or season not found

---

[API](https://skmtc.dev/luminatedata/apis/luminate-svm-api.md) - [All operations](https://skmtc.dev/luminatedata/apis/luminate-svm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/luminatedata/apis/luminate-svm-api/revisions/ff683b83f008?raw)