GET
/
3
/
account
/
{account_id}
/
watchlist
/
tv
Get watchlist 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": "/5hS2OIuZSKGkR8R5l3bY5zh04Ce.jpg",
      "first_air_date": "2006-10-05",
      "genre_ids": [
        16,
        10765,
        10759,
        18
      ],
      "id": 31724,
      "name": "Code Geass: Lelouch of the Rebellion",
      "origin_country": [
        "JP"
      ],
      "original_language": "ja",
      "original_name": "コードギアス 反逆のルルーシュ",
      "overview": "Japan has been invaded and conquered by the Britannian Empire. Japan is now known as Area 11 and its citizens known as Elevens. The Britannian Empire takes away Japan's autonomous power and imposes its rule through the use of Knightmares. The Empire's rule has never faltered, but cracks have begun to show...",
      "popularity": 161.186,
      "poster_path": "/2cBDhzbP7KOLbWtTzxS4WIDLh70.jpg",
      "vote_average": 8.372,
      "vote_count": 740
    }
  ],
  "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
integer
required

A unique numeric identifier for a user account on TMDB. See how to get account id here.

Example:

548

Query Parameters

​
session_id
string

A unique identifier for an authenticated user session. Usually used for user authentication

Example:

"02a0e6d34dbd8325254e83c78918599076a62b0e"

​
language
string

The language and region of the content, represented by an ISO 639-1 and ISO 3166-1 code combination (e.g, en-US for English, United States.). Defaults to en-US.

Example:

"en-US"

​
page
integer

A specific page number to get results for. Defaults to 1

Example:

1

​
sort_by
enum<string>

Used to determine the order in which results are sorted in the response (ascending or descending). Allowed values: * created_at.asc: Sort by date created in ascending order * created_at.desc: sort by date created in descending order Defaults to created_at.asc

Available options:
created_at.asc,
created_at.desc

Response

200 - application/json

Request successful

​
page
number

Current page number of the results

Example:

1

​
results
object[]
Example:
[
  {
    "adult": false,
    "backdrop_path": "/5hS2OIuZSKGkR8R5l3bY5zh04Ce.jpg",
    "first_air_date": "2006-10-05",
    "genre_ids": [16, 10765, 10759, 18],
    "id": 31724,
    "name": "Code Geass: Lelouch of the Rebellion",
    "origin_country": ["JP"],
    "original_language": "ja",
    "original_name": "コードギアス 反逆のルルーシュ",
    "overview": "Japan has been invaded and conquered by the Britannian Empire. Japan is now known as Area 11 and its citizens known as Elevens. The Britannian Empire takes away Japan's autonomous power and imposes its rule through the use of Knightmares. The Empire's rule has never faltered, but cracks have begun to show...",
    "popularity": 161.186,
    "poster_path": "/2cBDhzbP7KOLbWtTzxS4WIDLh70.jpg",
    "vote_average": 8.372,
    "vote_count": 740
  }
]
​
total_pages
number

The total number of pages returned in the response

Example:

1

​
total_results
number

The total number of results returned in the response

Example:

1