Skip to main content
GET
/
3
/
account
/
{account_id}
/
watchlist
/
movies
Movies Watchlist
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": "/tElnmtQ6yz1PjN1kePNl8yMSb59.jpg",
      "genre_ids": [
        16,
        12,
        10751,
        35
      ],
      "id": 1241982,
      "original_language": "en",
      "original_title": "Moana 2",
      "overview": "After receiving an unexpected call from her wayfinding ancestors, Moana journeys alongside Maui and a new crew to the far seas of Oceania and into dangerous, long-lost waters for an adventure unlike anything she's ever faced.",
      "popularity": 5883.763,
      "poster_path": "/yh64qw9mgXBvlaWDi7Q9tpUBAvH.jpg",
      "release_date": "2024-11-27",
      "title": "Moana 2",
      "video": false,
      "vote_average": 6.938,
      "vote_count": 316
    }
  ],
  "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

This represents your account ID. Get it here

Query Parameters

​
language
string

This represents the movie language.

Example:

"en"

​
page
string

This represents the page number.

Example:

"1"

​
session_id
string

This represents your session Id. Get it here

​
sort_by
string

This specifies the order in which the retrieved list will be displayed.

Example:

"created_at.asc"

Response

200 - application/json

Movies Watchlist

​
page
number
Example:

1

​
results
object[]
Example:
[
  {
    "adult": false,
    "backdrop_path": "/tElnmtQ6yz1PjN1kePNl8yMSb59.jpg",
    "genre_ids": [16, 12, 10751, 35],
    "id": 1241982,
    "original_language": "en",
    "original_title": "Moana 2",
    "overview": "After receiving an unexpected call from her wayfinding ancestors, Moana journeys alongside Maui and a new crew to the far seas of Oceania and into dangerous, long-lost waters for an adventure unlike anything she's ever faced.",
    "popularity": 5883.763,
    "poster_path": "/yh64qw9mgXBvlaWDi7Q9tpUBAvH.jpg",
    "release_date": "2024-11-27",
    "title": "Moana 2",
    "video": false,
    "vote_average": 6.938,
    "vote_count": 316
  }
]
​
total_pages
number
Example:

1

​
total_results
number
Example:

1