---
title: "GET /series/filter"
method: GET
path: "/series/filter"
tags: ["Series"]
---

# GET /series/filter

`GET /series/filter`

Search series based on filter parameters

## Query parameters

- `company` number
- `contentRating` number
- `country` string, required
- `genre` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36
- `lang` string, required
- `sort` 'score' | 'firstAired' | 'lastAired' | 'name'
- `sortType` 'asc' | 'desc'
- `status` 1 | 2 | 3
- `year` number

## Response `200`

response

- object
  - `data` SeriesBaseRecord[]
    - `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.
    - `averageRuntime` integer, nullable
    - `country` string
    - `defaultSeasonType` integer
    - `episodes` 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[]
              - …
            - `country` string
            - `id` integer
            - `inactiveDate` string
            - `name` string
            - `nameTranslations` string[]
            - `overviewTranslations` string[]
            - `primaryCompanyType` integer, nullable
            - `slug` string
            - `parentCompany` ParentCompany — A parent company record
              - …
            - `tagOptions` TagOption[]
              - …
          - `network` Company[]
            - `activeDate` string
            - `aliases` Alias[]
              - …
            - `country` string
            - `id` integer
            - `inactiveDate` string
            - `name` string
            - `nameTranslations` string[]
            - `overviewTranslations` string[]
            - `primaryCompanyType` integer, nullable
            - `slug` string
            - `parentCompany` ParentCompany — A parent company record
              - …
            - `tagOptions` TagOption[]
              - …
          - `production` Company[]
            - `activeDate` string
            - `aliases` Alias[]
              - …
            - `country` string
            - `id` integer
            - `inactiveDate` string
            - `name` string
            - `nameTranslations` string[]
            - `overviewTranslations` string[]
            - `primaryCompanyType` integer, nullable
            - `slug` string
            - `parentCompany` ParentCompany — A parent company record
              - …
            - `tagOptions` TagOption[]
              - …
          - `distributor` Company[]
            - `activeDate` string
            - `aliases` Alias[]
              - …
            - `country` string
            - `id` integer
            - `inactiveDate` string
            - `name` string
            - `nameTranslations` string[]
            - `overviewTranslations` string[]
            - `primaryCompanyType` integer, nullable
            - `slug` string
            - `parentCompany` ParentCompany — A parent company record
              - …
            - `tagOptions` TagOption[]
              - …
          - `special_effects` Company[]
            - `activeDate` string
            - `aliases` Alias[]
              - …
            - `country` string
            - `id` integer
            - `inactiveDate` string
            - `name` string
            - `nameTranslations` string[]
            - `overviewTranslations` string[]
            - `primaryCompanyType` integer, nullable
            - `slug` string
            - `parentCompany` ParentCompany — A parent company record
              - …
            - `tagOptions` TagOption[]
              - …
        - `seriesId` integer
        - `type` SeasonType — season type record
          - `alternateName` string
          - `id` integer
          - `name` string
          - `type` string
        - `year` string
      - `seriesId` integer
      - `seasonName` string
      - `year` string
    - `firstAired` string
    - `id` integer
    - `image` string
    - `isOrderRandomized` boolean
    - `lastAired` string
    - `lastUpdated` string
    - `name` string
    - `nameTranslations` string[]
    - `nextAired` string
    - `originalCountry` string
    - `originalLanguage` string
    - `overviewTranslations` string[]
    - `score` number, double
    - `slug` string
    - `status` Status — status record
      - `id` integer, nullable
      - `keepUpdated` boolean
      - `name` string
      - `recordType` string
    - `year` string

## Other responses

- `400` — Invalid format parameter.
- `401` — Unauthorized

## Changes

- **2024-04-27** `47f34dd2fd7e` — 1 info
  - added the optional property `data/items/episodes/items/absoluteNumber` to the response with the `200` status
- **2024-03-24** `f825d3005872` — 5 breaking
  - the response property `data/items/episodes/items/seasons/items/companies/distributor/items/primaryCompanyType` became nullable for the status `200`
  - the response property `data/items/episodes/items/seasons/items/companies/network/items/primaryCompanyType` became nullable for the status `200`
  - the response property `data/items/episodes/items/seasons/items/companies/production/items/primaryCompanyType` became nullable for the status `200`
  - the response property `data/items/episodes/items/seasons/items/companies/special_effects/items/primaryCompanyType` became nullable for the status `200`
  - …1 more
- **2024-02-08** `8cb67a07c134` — 4 breaking, 60 warning
  - the response property `data/items/averageRuntime` became nullable for the status `200`
  - the response property `data/items/episodes/items/imageType` became nullable for the status `200`
  - the response property `data/items/episodes/items/runtime` became nullable for the status `200`
  - the response property `data/items/status/id` became nullable for the status `200`
  - …60 more
- **2022-10-04** `ad6b2826f387` — 1 info
  - added the optional property `data/items/episodes/items/linkedMovie` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/thetvdb/apis/tvdb-api-v4/changes/series/filter/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)