Skip to main content
GET
/
4
/
account
/
{account_object_id}
/
movie
/
watchlist
Watchlist Movies
curl --request GET \
  --url https://api.themoviedb.org/4/account/{account_object_id}/movie/watchlist \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/2w4xG178RpB4MDAIfTkqAuSJzec.jpg",
      "genre_ids": [
        12,
        28,
        878
      ],
      "id": 11,
      "original_language": "en",
      "original_title": "Star Wars",
      "overview": "Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire.",
      "popularity": 15.6594,
      "poster_path": "/6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg",
      "release_date": "1977-05-25",
      "title": "Star Wars",
      "video": false,
      "vote_average": 8.203,
      "vote_count": 21012
    }
  ],
  "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_object_id
string
required

The account object ID.

Query Parameters

​
page
integer

The page number of a list.

​
language
string

Defaults to en-US

​
sort_by
integer

Defaults to created_at.asc

Response

200 - application/json;charset=utf-8

Successful

​
page
integer

The current page number in the paginated response.

​
results
object[]

A list of movie or TV show objects.

​
total_pages
integer

The total number of pages available for the list.

​
total_results
integer

The total number of results returned.