Skip to main content
GET
/
4
/
account
/
{account_object_id}
/
lists
Lists
curl --request GET \
  --url https://api.themoviedb.org/4/account/{account_object_id}/lists \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "account_object_id": "62f6e4aef92532007e99d09b",
      "adult": 0,
      "average_rating": 0,
      "backdrop_path": null,
      "created_at": "2025-01-02 15:41:28 UTC",
      "description": "Just an awesome list.",
      "featured": 0,
      "id": 8504752,
      "iso_3166_1": "US",
      "iso_639_1": "en",
      "name": "This is my awesome test list.",
      "number_of_items": 0,
      "poster_path": null,
      "public": 1,
      "revenue": 0,
      "runtime": "0",
      "sort_by": 1,
      "updated_at": "2025-01-02 15:41:28 UTC"
    }
  ],
  "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_object_id
string
required

The account object ID.

Query Parameters

​
page
integer

The page number of a list.

Response

200 - application/json;charset=utf-8

Successful

​
page
integer

The current page number in the paginated response.

​
results
object[]

A list of movie or TV show objects.

​
total_pages
integer

The total number of pages available for the list.

​
total_results
integer

The total number of results returned.