GET /series/filter — tvdb-api-v4

Artwork2

Artwork Statuses1

Artwork Types1

Award Categories2

Awards3

Characters1

Companies3

Content Ratings1

Countries1

Entity Types1

Episodes4

Favorites2

Genders1

Genres2

InspirationTypes1

Languages1

Lists5

Login1

Movie Statuses1

Movies6

People4

People Types1

Search2

Seasons5

Series10

Series Statuses1

Source Types1

Updates1

User info2

Series

Search series based on filter parameters

get/series/filter

Query parameters

companynumber

Example:1

production company

contentRatingnumber

Example:245

content rating id base on a country

countrystring required

Example:usa

country of origin

genre1 | 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

Example:3

Genre id. This id can be found using /genres endpoint.

langstring required

Example:eng

original language

sort'score' | 'firstAired' | 'lastAired' | 'name'

sort by results

sortType'asc' | 'desc'

sort type ascending or descending

status1 | 2 | 3

status

yearnumber

Example:2020

release year

Response

response

Changes

Changed in 16 of the 50 revisions of this API.139698

Apr 27, 202447f34dd2fd7e1See the full diff
- ○
  added the optional property data/items/episodes/items/absoluteNumber to the response with the 200 status
  response-optional-property-added
Mar 24, 2024f825d30058725See the full diff
- ▲
  the response property data/items/episodes/items/seasons/items/companies/distributor/items/primaryCompanyType became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property data/items/episodes/items/seasons/items/companies/network/items/primaryCompanyType became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property data/items/episodes/items/seasons/items/companies/production/items/primaryCompanyType became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property data/items/episodes/items/seasons/items/companies/special_effects/items/primaryCompanyType became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property data/items/episodes/items/seasons/items/companies/studio/items/primaryCompanyType became nullable for the status 200
  response-property-became-nullable
Feb 8, 20248cb67a07c134460See the full diff
- ▲
  the response property data/items/averageRuntime became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property data/items/episodes/items/imageType became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property data/items/episodes/items/runtime became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property data/items/status/id became nullable for the status 200
  response-property-became-nullable
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/distributor/activeDate from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/distributor/aliases from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/distributor/country from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/distributor/id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/distributor/inactiveDate from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/distributor/name from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/distributor/nameTranslations from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/distributor/overviewTranslations from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/distributor/parentCompany from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/distributor/primaryCompanyType from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/distributor/slug from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/distributor/tagOptions from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/network/activeDate from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/network/aliases from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/network/country from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/network/id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/network/inactiveDate from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/network/name from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/network/nameTranslations from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/network/overviewTranslations from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/network/parentCompany from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/network/primaryCompanyType from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/network/slug from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/network/tagOptions from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/production/activeDate from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/production/aliases from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/production/country from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/production/id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/production/inactiveDate from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/production/name from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/production/nameTranslations from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/production/overviewTranslations from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/production/parentCompany from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/production/primaryCompanyType from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/production/slug from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/production/tagOptions from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/special_effects/activeDate from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/special_effects/aliases from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/special_effects/country from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/special_effects/id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/special_effects/inactiveDate from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/special_effects/name from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/special_effects/nameTranslations from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/special_effects/overviewTranslations from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/special_effects/parentCompany from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/special_effects/primaryCompanyType from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/special_effects/slug from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/special_effects/tagOptions from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/studio/activeDate from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/studio/aliases from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/studio/country from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/studio/id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/studio/inactiveDate from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/studio/name from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/studio/nameTranslations from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/studio/overviewTranslations from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/studio/parentCompany from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/studio/primaryCompanyType from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/studio/slug from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/seasons/items/companies/studio/tagOptions from the response with the 200 status
  response-optional-property-removed
Oct 4, 2022ad6b2826f3871See the full diff
- ○
  added the optional property data/items/episodes/items/linkedMovie to the response with the 200 status
  response-optional-property-added
Aug 9, 2022499c304033fa3See the full diff
- ○
  added the optional property data/items/episodes/items/seasons/items/year to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/episodes/items/year to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/year to the response with the 200 status
  response-optional-property-added
Aug 9, 2022925b928e7ab93See the full diff
- ●
  removed the optional property data/items/episodes/items/seasons/items/year from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/episodes/items/year from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/year from the response with the 200 status
  response-optional-property-removed
Aug 9, 2022fa722c5145233See the full diff
- ○
  added the optional property data/items/episodes/items/seasons/items/year to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/episodes/items/year to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/year to the response with the 200 status
  response-optional-property-added
Aug 1, 2022b04adee4ad321See the full diff
- ○
  added the optional property data/items/slug to the response with the 200 status
  response-optional-property-added
Jul 12, 20227cfc67e90b131See the full diff
- ○
  added the optional property data/items/episodes/items/seasons/items/lastUpdated to the response with the 200 status
  response-optional-property-added
Jul 12, 20228c2ec62cc6542See the full diff
- ○
  added the new optional query request parameter sortType
  new-optional-request-parameter
- ○
  added the new enum value lastAired to the query request parameter sort
  request-parameter-enum-value-added

Full history (16 revisions)