GET
/
3
/
list
/
{list_id}
Details
curl --request GET \
  --url https://api.themoviedb.org/3/list/{list_id} \
  --header 'Authorization: Bearer <token>'
{
  "created_by": "SirJosh",
  "description": "This contains the list of all anime, movie or TV shows",
  "favorite_count": 0,
  "id": 8504997,
  "iso_639_1": "en",
  "item_count": 1,
  "items": [
    {
      "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": 69.185,
      "poster_path": "/fPtlCO1yQtnoLHOwKtWz7db6RGU.jpg",
      "release_date": "1997-05-02",
      "title": "The Fifth Element",
      "video": false,
      "vote_average": 7.554,
      "vote_count": 10764
    }
  ],
  "name": "Anime",
  "page": 1,
  "poster_path": null,
  "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.

Query Parameters

language
string

Specifies the language in which the response should be returned.

Example:

"en-US"

list_id
number
required

This is the unique identifier of the list been created

Example:

""

page
integer

Indicates which page of results to return. Default is the first page (1).

Example:

1

Response

200 - application/json

details

created_by
string

The name of the user who created the list.

Example:

"SirJosh"

description
string

A textual description of the list.

Example:

"This contains the list of all anime, movie or TV shows"

favorite_count
number

The number of users who have marked the list as a favorite (default is 0).

Example:

0

id
number

The unique identifier for the list.

Example:

8504997

iso_639_1
string

The ISO 639-1 code for the language of the list.

Example:

"en"

item_count
number

The total number of items in the list.

Example:

1

items
object[]

A collection of items (movies/shows) contained in the list.

Example:
[
{
"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": 69.185,
"poster_path": "/fPtlCO1yQtnoLHOwKtWz7db6RGU.jpg",
"release_date": "1997-05-02",
"title": "The Fifth Element",
"video": false,
"vote_average": 7.554,
"vote_count": 10764
}
]
name
string

The name of the list.

Example:

"Anime"

page
number

The current page number of the results being displayed.

Example:

1

poster_path
any

The path of the poster image associated with the list. When poster_path is null, it means that the item does not have an associated poster image in the database.

total_pages
number

The total number of pages available for the query results.

Example:

1

total_results
number

The total number of results found for the query.

Example:

1