Skip to main content
GET
/
account
/
{account_id}
/
watchlist
/
tv
List watchlisted TV shows
curl --request GET \
  --url 'https://api.themoviedb.org/3/account/{{account_id}}/watchlist/tv' \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/lBoHzOgft2QfpjkVVvZCqeM4ttT.jpg",
      "first_air_date": "2024-11-17",
      "genre_ids": [
        10765,
        18,
        10759
      ],
      "id": 90228,
      "name": "Dune: Prophecy",
      "origin_country": [
        "US"
      ],
      "original_language": "en",
      "original_name": "Dune: Prophecy",
      "overview": "Ten thousand years before the ascension of Paul Atreides, sisters Valya and Tula Harkonnen establish the fabled sect and female order that would become known as the Bene Gesserit to control the future of humankind.",
      "popularity": 1001.067,
      "poster_path": "/5B8Cxz8ZZXp3w2WmmdKTXpkS24e.jpg",
      "vote_average": 7.9,
      "vote_count": 112
    }
  ],
  "total_pages": 1,
  "total_results": 1
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
account_id
string
required

Query Parameters

​
language
string

language format of the details you want to get.

Example:

"en-US"

​
page
string

what page the query belongs

Example:

"1"

​
sort_by
string

filter the query by ascending or descending order

Example:

"created_at.asc"

​
session_id
string

filter by the user session ID

Example:

"string"

Response

200 - application/json

Watchlist TV

​
page
number
Example:

1

​
results
object[]
Example:
[
  {
    "adult": false,
    "backdrop_path": "/lBoHzOgft2QfpjkVVvZCqeM4ttT.jpg",
    "first_air_date": "2024-11-17",
    "genre_ids": [10765, 18, 10759],
    "id": 90228,
    "name": "Dune: Prophecy",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Dune: Prophecy",
    "overview": "Ten thousand years before the ascension of Paul Atreides, sisters Valya and Tula Harkonnen establish the fabled sect and female order that would become known as the Bene Gesserit to control the future of humankind.",
    "popularity": 1001.067,
    "poster_path": "/5B8Cxz8ZZXp3w2WmmdKTXpkS24e.jpg",
    "vote_average": 7.9,
    "vote_count": 112
  }
]
​
total_pages
number
Example:

1

​
total_results
number
Example:

1