Skip to main content
GET
/
3
/
account
/
{account_id}
/
lists
Get an account lists
curl --request GET \
  --url https://api.themoviedb.org/3/account/{account_id}/lists \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "description": "List of movies and tv shows I plan to watch.",
      "favorite_count": 0,
      "id": 8500157,
      "iso_639_1": "en",
      "item_count": 1,
      "list_type": "movie",
      "name": "To be watched",
      "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.

Path Parameters

​
account_id
integer
required

A unique numeric identifier for a user account on TMDB. See how to get account id here.

Example:

548

Query Parameters

​
session_id
string

A unique identifier for an authenticated user session. Usually used for user authentication

Example:

"02a0e6d34dbd8325254e83c78918599076a62b0e"

​
page
integer

A specific page number to get results for. Defaults to 1

Example:

1

Response

200 - application/json

Request successful

​
page
number
Example:

1

​
results
object[]
Example:
[
  {
    "description": "List of movies and tv shows I plan to watch.",
    "favorite_count": 0,
    "id": 8500157,
    "iso_639_1": "en",
    "item_count": 1,
    "list_type": "movie",
    "name": "To be watched",
    "poster_path": null
  }
]
​
total_pages
number
Example:

1

​
total_results
number
Example:

1