GET
/
3
/
account
/
{account_id}
/
lists
curl --request GET \
  --url https://api.themoviedb.org/3/account/{account_id}/lists \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "description": "This is a story to test this API endpoint",
      "favorite_count": 0,
      "id": 8504086,
      "iso_639_1": "en",
      "item_count": 1,
      "list_type": "movie",
      "name": "True Story Of Nnekka",
      "poster_path": null
    },
    {
      "description": "This is a story to test this API endpoint",
      "favorite_count": 0,
      "id": 8505816,
      "iso_639_1": "en",
      "item_count": 0,
      "list_type": "movie",
      "name": "True Story Of Nnekka",
      "poster_path": null
    },
    {
      "description": "Just an awesome list.",
      "favorite_count": 0,
      "id": 8504985,
      "iso_639_1": "en",
      "item_count": 1,
      "list_type": "movie",
      "name": "This is my awesome test list.",
      "poster_path": null
    }
  ],
  "total_pages": 1,
  "total_results": 3
}

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

user's account id

Query Parameters

session_id
string

session ID for authentication or tracking purposes

Example:

""

page
integer
default:1

page number to retrieve specific paginated results.

Response

200 - application/json

Lists

The response is of type object.