GET
/
3
/
account
/
{account_id}
/
watchlist
/
movies
Watchlist Movies
curl --request GET \
  --url https://api.themoviedb.org/3/account/{account_id}/watchlist/movies \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/4qCqAdHcNKeAHcK8tJ8wNJZa9cx.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": 101.129,
      "poster_path": "/6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg",
      "release_date": "1977-05-25",
      "title": "Star Wars",
      "video": false,
      "vote_average": 8.203,
      "vote_count": 20688
    }
  ],
  "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

unique identifier of user's account

Query Parameters

​
page
integer
default:1

page number to retrieve specific paginated results.

​
session_id
string

session ID for authentication or tracking purposes

​
language
string
default:en-US

language based on region

​
sort_by
enum<string>

Sort the results either in ascending order or descending order

Available options:
created_at.asc,
created_at.desc

Response

200 - application/json

Watchlist Movies

​
page
number
Example:

1

​
results
object[]
Example:
[
  {
    "adult": false,
    "backdrop_path": "/4qCqAdHcNKeAHcK8tJ8wNJZa9cx.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": 101.129,
    "poster_path": "/6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg",
    "release_date": "1977-05-25",
    "title": "Star Wars",
    "video": false,
    "vote_average": 8.203,
    "vote_count": 20688
  }
]
​
total_pages
number
Example:

1

​
total_results
number
Example:

1