Skip to main content
GET
/
movie
/
{movie_id}
/
lists
Lists
curl --request GET \
  --url https://api.themoviedb.org/3/movie/{movie_id}/lists \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "description": "Master List In Progress",
      "favorite_count": 0,
      "id": 51108,
      "item_count": 11778,
      "iso_639_1": "en",
      "iso_3166_1": "US",
      "list_type": "movie",
      "name": "My Movies",
      "poster_path": null
    },
    {
      "description": "",
      "favorite_count": 0,
      "id": 8168597,
      "item_count": 15719,
      "iso_639_1": "en",
      "iso_3166_1": "US",
      "list_type": "movie",
      "name": "movies",
      "poster_path": null
    },
    {
      "description": "Select a title for trailers and more.\r\n\r\nCain Cinema features a 4K UHD picture on a 120\" (16:9) screen, and a 7.2.4 Dolby Atmos audio experience. ",
      "favorite_count": 0,
      "id": 7081593,
      "item_count": 1678,
      "iso_639_1": "en",
      "iso_3166_1": "US",
      "list_type": "movie",
      "name": "Now Showing at Cain Cinema",
      "poster_path": null
    },
    {
      "description": "Photography aligned with beauty.",
      "favorite_count": 0,
      "id": 8501221,
      "item_count": 1762,
      "iso_639_1": "en",
      "iso_3166_1": "US",
      "list_type": "movie",
      "name": "Cinematography One",
      "poster_path": null
    },
    {
      "description": "Peliculas vistas",
      "favorite_count": 0,
      "id": 132058,
      "item_count": 407,
      "iso_639_1": "en",
      "iso_3166_1": "US",
      "list_type": "movie",
      "name": "Vistas",
      "poster_path": null
    },
    {
      "description": "",
      "favorite_count": 0,
      "id": 8307602,
      "item_count": 303,
      "iso_639_1": "en",
      "iso_3166_1": "US",
      "list_type": "movie",
      "name": "JBO - Films",
      "poster_path": null
    },
    {
      "description": "",
      "favorite_count": 0,
      "id": 8504882,
      "item_count": 3,
      "iso_639_1": "en",
      "iso_3166_1": "US",
      "list_type": "movie",
      "name": "comedy",
      "poster_path": null
    },
    {
      "description": "My Blu-ray collection.",
      "favorite_count": 0,
      "id": 82018,
      "item_count": 418,
      "iso_639_1": "en",
      "iso_3166_1": "US",
      "list_type": "movie",
      "name": "Blu-rays",
      "poster_path": null
    },
    {
      "description": "Films and TV I have in collection",
      "favorite_count": 0,
      "id": 8261951,
      "item_count": 760,
      "iso_639_1": "en",
      "iso_3166_1": "US",
      "list_type": "movie",
      "name": "Collection",
      "poster_path": null
    },
    {
      "description": "",
      "favorite_count": 0,
      "id": 8197238,
      "item_count": 253,
      "iso_639_1": "en",
      "iso_3166_1": "US",
      "list_type": "movie",
      "name": "Foreign Films",
      "poster_path": null,
      "total_pages": 96,
      "total_results": 1914
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
movie_id
integer
required

The ID of the movie

Query Parameters

​
language
string

Defaults to false

​
page
integer

Defaults to 1

Response

200 - application/json

Successful

​
id
integer

A unique identify

​
page
integer

Indicates the current page number

​
results
object[]

Contains the list of data or items

​
total_pages
integer

Specifies the total number of pages available

​
total_results
integer

Represents the total number of items or records in a dataset