GET
/
3
/
list
/
{list_id}
Retrieve a list
curl --request GET \
  --url https://api.themoviedb.org/3/list/{list_id} \
  --header 'Authorization: Bearer <token>'
{
  "created_by": "Emiloju",
  "description": "A list of movies for the holiday season",
  "favorite_count": 0,
  "id": 8504581,
  "iso_639_1": "en",
  "item_count": 0,
  "items": [],
  "name": "Christmas movie list.",
  "page": 1,
  "poster_path": null,
  "total_pages": 1,
  "total_results": 0
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
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

Response

200 - application/json

Request successful

​
created_by
string

The creator of the list

Example:

"Emiloju"

​
description
string

The description for the list

Example:

"List of movies and tv shows I plan to watch."

​
favorite_count
number

The number of times the list item has been marked favorite by users

Example:

0

​
id
number

The unique identifier for the list

Example:

8500157

​
iso_639_1
string

A two letter code that represents the language used in the response.

Example:

"en"

​
item_count
number

The number of items in the list

Example:

2

​
items
object[]

An array of items in the list

Example:
[
  {
    "adult": false,
    "backdrop_path": "/5hS2OIuZSKGkR8R5l3bY5zh04Ce.jpg",
    "first_air_date": "2006-10-05",
    "genre_ids": [16, 10765, 10759, 18],
    "id": 31724,
    "media_type": "tv",
    "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": 109.544,
    "poster_path": "/n8ju74bg2k5MmDn5RBF6qMbhIlG.jpg",
    "vote_average": 8.4,
    "vote_count": 747
  },
  {
    "adult": false,
    "backdrop_path": "/wgvc3PmjQGtYYDWaeuV867mnFDs.jpg",
    "genre_ids": [878, 28, 12],
    "id": 18,
    "media_type": "movie",
    "original_language": "fr",
    "original_title": "Le Cinquième Élément",
    "overview": "In 2257, a taxi driver is unintentionally given the task of saving a young girl who is part of the key that will ensure the survival of humanity.",
    "popularity": 65.447,
    "poster_path": "/fPtlCO1yQtnoLHOwKtWz7db6RGU.jpg",
    "release_date": "1997-05-02",
    "title": "The Fifth Element",
    "video": false,
    "vote_average": 7.553,
    "vote_count": 10758
  }
]
​
name
string

The list's name

Example:

"To be watched"

​
page
number

Current page number of the results

Example:

1

​
poster_path
any

The path to the item's poster image

​
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