--- updatedAt: 2025-10-01T20:31:00.000Z agentTools: projectIndex: https://developer.themoviedb.org/v4/llms.txt --- # Lists Get the custom lists that a user has created. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "tmdb-api", "version": "4" }, "servers": [ { "url": "https://api.themoviedb.org" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "name": "Authorization", "x-bearer-format": "bearer", "x-default": "" } } }, "security": [ { "sec0": [] } ], "paths": { "/4/account/{account_object_id}/lists": { "get": { "summary": "Lists", "description": "Get the custom lists that a user has created.", "operationId": "account-lists", "parameters": [ { "name": "account_object_id", "in": "path", "schema": { "type": "string", "default": "<>" }, "required": true }, { "name": "page", "in": "query", "schema": { "type": "integer", "format": "int32", "default": 1 } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"page\": 1,\n \"results\": [\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 7.90183,\n \"created_at\": \"2019-08-27 15:13:15\",\n \"description\": \"\",\n \"featured\": 0,\n \"id\": 120174,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"Test Alpha Sort\",\n \"number_of_items\": 6,\n \"public\": 0,\n \"revenue\": \"586453267\",\n \"runtime\": 644,\n \"sort_by\": 7,\n \"updated_at\": \"2023-05-05 16:49:11\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 0,\n \"backdrop_path\": \"/ew5FcYiRhTYNJAkxoVPMNlCOdVn.jpg\",\n \"created_at\": \"2022-10-06 15:34:43\",\n \"description\": \"\",\n \"featured\": 0,\n \"id\": 8221116,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"Test List\",\n \"number_of_items\": 4,\n \"public\": 0,\n \"revenue\": \"0\",\n \"runtime\": 0,\n \"sort_by\": 1,\n \"updated_at\": \"2023-01-23 22:13:47\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 5.61526,\n \"backdrop_path\": \"/m6MYSifkYciC4hpjG96zBe39cHR.jpg\",\n \"created_at\": \"2012-11-02 18:44:08\",\n \"description\": \"Here's a list of the films that take place in the DC Comics universe.\",\n \"featured\": 1,\n \"id\": 3,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"The DC Comics Universe\",\n \"number_of_items\": 30,\n \"poster_path\": \"/4H1jWsgEQOgTs4KeG5j5BorKMfX.jpg\",\n \"public\": 1,\n \"revenue\": \"10492067637\",\n \"runtime\": 3592,\n \"sort_by\": 6,\n \"updated_at\": \"2022-10-25 22:57:19\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 6.999,\n \"created_at\": \"2022-08-01 22:23:32\",\n \"description\": \"This is a test.\",\n \"featured\": 0,\n \"id\": 8212330,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"Test List #1\",\n \"number_of_items\": 2,\n \"public\": 0,\n \"revenue\": \"0\",\n \"runtime\": 128,\n \"sort_by\": 1,\n \"updated_at\": \"2022-08-18 20:26:35\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 8.548,\n \"created_at\": \"2020-11-26 21:33:06\",\n \"description\": \"Just a UTF test list. 🍩 🐝\",\n \"featured\": 0,\n \"id\": 7066467,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"🚨 My Cool List!\",\n \"number_of_items\": 3,\n \"public\": 0,\n \"revenue\": \"0\",\n \"runtime\": 124,\n \"sort_by\": 3,\n \"updated_at\": \"2022-02-15 16:59:58\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 6.04565,\n \"backdrop_path\": \"/kaIfm5ryEOwYg8mLbq8HkPuM1Fo.jpg\",\n \"created_at\": \"2012-11-02 18:27:03\",\n \"description\": \"The idea behind this list is to collect the live action comic book movies from within the Marvel franchise.\",\n \"featured\": 1,\n \"id\": 1,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"The Marvel Universe\",\n \"number_of_items\": 59,\n \"poster_path\": \"/coJVIUEOToAEGViuhclM7pXC75R.jpg\",\n \"public\": 1,\n \"revenue\": \"22376320295\",\n \"runtime\": 5734,\n \"sort_by\": 6,\n \"updated_at\": \"2021-12-15 14:21:26\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 7.8205,\n \"created_at\": \"2020-03-14 15:43:10\",\n \"description\": \"Test description.\",\n \"featured\": 0,\n \"id\": 136203,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"Test From Trav's Scripts\",\n \"number_of_items\": 2,\n \"public\": 0,\n \"revenue\": \"100853753\",\n \"runtime\": 189,\n \"sort_by\": 1,\n \"updated_at\": \"2020-06-22 22:05:42\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 6.53333,\n \"created_at\": \"2020-05-14 16:55:25\",\n \"description\": \"\",\n \"featured\": 0,\n \"id\": 142798,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"UFC Test\",\n \"number_of_items\": 3,\n \"public\": 1,\n \"revenue\": \"6428490\",\n \"runtime\": 446,\n \"sort_by\": 7,\n \"updated_at\": \"2020-05-14 16:56:58\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 6.96797,\n \"backdrop_path\": \"/bYimqNnizPUCnL5HOdoCW02IGmH.jpg\",\n \"created_at\": \"2012-11-02 18:38:56\",\n \"description\": \"A list of the films that were nominated at the 2012 Oscars for best picture.\",\n \"featured\": 0,\n \"id\": 2,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"2012 Oscar Nominations for Best Picture - 84th Academy Awards\",\n \"number_of_items\": 9,\n \"poster_path\": \"/zRqBleU93WncYnIwt8LAanQerZ7.jpg\",\n \"public\": 1,\n \"revenue\": \"1169550746\",\n \"runtime\": 1128,\n \"sort_by\": 1,\n \"updated_at\": \"2020-05-14 16:48:14\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 6.91976,\n \"backdrop_path\": \"/hjQp148VjWF4KjzhsD90OCMr11h.jpg\",\n \"created_at\": \"2014-01-14 23:08:25\",\n \"description\": \"Here are the films that have won for best drama at the Golden Globes.\",\n \"featured\": 1,\n \"id\": 2469,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"Best Picture Winners - The Golden Globes\",\n \"number_of_items\": 63,\n \"poster_path\": \"/zkjL4XYZkbSKPYJgK1goBYS9EVN.jpg\",\n \"public\": 1,\n \"revenue\": \"14593415539\",\n \"runtime\": 8994,\n \"sort_by\": 1,\n \"updated_at\": \"2020-05-14 16:47:11\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 6.82273,\n \"backdrop_path\": \"/eS8rJ1KzRNBewx9MduiSHM4kr7S.jpg\",\n \"created_at\": \"2012-11-03 20:14:12\",\n \"description\": \"Name pretty much says it all, here's the top 50 grossing films of all time.\",\n \"featured\": 0,\n \"id\": 10,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"Top 50 Grossing Films of All Time (Worldwide)\",\n \"number_of_items\": 50,\n \"poster_path\": \"/sRbZeVtRKIWybTOVpCRPZtzW5bd.jpg\",\n \"public\": 1,\n \"revenue\": \"47641796988\",\n \"runtime\": 6825,\n \"sort_by\": 1,\n \"updated_at\": \"2020-05-14 16:44:22\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 6.9491,\n \"backdrop_path\": \"/iVk4mVKwNE66JbBcoDwcYFvuUXM.jpg\",\n \"created_at\": \"2013-12-24 06:34:38\",\n \"description\": \"A list of the films that were nominated at the 2013 Oscars for best picture.\",\n \"featured\": 0,\n \"id\": 2278,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"2013 Oscar Nominations for Best Picture - 85th Academy Awards\",\n \"number_of_items\": 9,\n \"poster_path\": \"/AfyPUSSn7E75daZ3SfENRbA25h9.jpg\",\n \"public\": 1,\n \"revenue\": \"2363318819\",\n \"runtime\": 1217,\n \"sort_by\": 1,\n \"updated_at\": \"2020-05-14 16:41:21\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 6.55867,\n \"backdrop_path\": \"/7FWlcZq3r6525LWOcvO9kNWurN1.jpg\",\n \"created_at\": \"2012-11-03 14:58:28\",\n \"description\": \"A list of the theatrical releases for Marvel's Avengers characters that are in the latest Avengers movie.\",\n \"featured\": 0,\n \"id\": 5,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"The Avengers\",\n \"number_of_items\": 10,\n \"poster_path\": \"/2i89ujVkhJebuoB2zy6QZcwbr2N.jpg\",\n \"public\": 1,\n \"revenue\": \"4980475974\",\n \"runtime\": 1127,\n \"sort_by\": 1,\n \"updated_at\": \"2020-05-14 16:40:58\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 7.13104,\n \"backdrop_path\": \"/kd9jFTTabg4xJpHDgxY0h8F9BzG.jpg\",\n \"created_at\": \"2012-11-10 20:58:47\",\n \"description\": \"A list of the films that were nominated at the 2008 Oscars for best picture.\",\n \"featured\": 0,\n \"id\": 27,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"2008 Oscar Nominations for Best Picture - 80th Academy Awards\",\n \"number_of_items\": 5,\n \"poster_path\": \"/nWwFabqFaBbukXdkUCmtnrFxPNh.jpg\",\n \"public\": 1,\n \"revenue\": \"701451025\",\n \"runtime\": 618,\n \"sort_by\": 1,\n \"updated_at\": \"2020-05-14 16:39:15\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 6.71735,\n \"backdrop_path\": \"/tdVeR7jZXIVxvMZHXJhtbh5ySs3.jpg\",\n \"created_at\": \"2012-11-04 16:02:57\",\n \"description\": \"The View Askewniverse is a fictional universe created by writer/director Kevin Smith, featured in several films, comics and a television series; it is named for Smith's production company, View Askew Productions.\",\n \"featured\": 0,\n \"id\": 15,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"The View Askewniverse\",\n \"number_of_items\": 6,\n \"poster_path\": \"/tGmU66LL8edoRm1RO7sbrz1xuhr.jpg\",\n \"public\": 1,\n \"revenue\": \"106501831\",\n \"runtime\": 630,\n \"sort_by\": 1,\n \"updated_at\": \"2020-05-14 16:38:55\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 7.12432,\n \"backdrop_path\": \"/9IZvClXvhSxlp41eT0CyUEsyjqy.jpg\",\n \"created_at\": \"2012-11-03 19:28:36\",\n \"description\": \"A list of the films that were nominated at the 2009 Oscars for best picture.\",\n \"featured\": 0,\n \"id\": 9,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"2009 Oscar Nominations for Best Picture - 81st Academy Awards\",\n \"number_of_items\": 5,\n \"poster_path\": \"/gShtwIvdSHgCEQRZfymNkEUEwFm.jpg\",\n \"public\": 1,\n \"revenue\": \"766429211\",\n \"runtime\": 660,\n \"sort_by\": 1,\n \"updated_at\": \"2020-05-14 16:34:29\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 7.39934,\n \"backdrop_path\": \"/hTYZ9tPvRZrL3rSf0tB38r53IG.jpg\",\n \"created_at\": \"2016-08-29 15:00:25\",\n \"description\": \"A list of the films that were nominated at the 2016 Oscars for best picture.\",\n \"featured\": 0,\n \"id\": 10291,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"2016 Oscar Nominations for Best Picture - 88th Academy Awards\",\n \"number_of_items\": 8,\n \"public\": 1,\n \"revenue\": \"1991391886\",\n \"runtime\": 1044,\n \"sort_by\": 1,\n \"updated_at\": \"2020-05-14 16:31:18\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 7.07984,\n \"backdrop_path\": \"/5eb7l7AE2yU0mvb38fR5qLNhDDH.jpg\",\n \"created_at\": \"2012-11-02 20:48:45\",\n \"description\": \"A list of the films that were nominated at the 2011 Oscars for best picture.\",\n \"featured\": 0,\n \"id\": 4,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"2011 Oscar Nominations for Best Picture - 83rd Academy Awards\",\n \"number_of_items\": 10,\n \"poster_path\": \"/iAHDZPyLD3NW7GuNV6U1TVtb0hN.jpg\",\n \"public\": 1,\n \"revenue\": \"3321305575\",\n \"runtime\": 1123,\n \"sort_by\": 1,\n \"updated_at\": \"2020-05-14 16:29:59\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 7.0216,\n \"backdrop_path\": \"/off0xgvtfHY82l3MC4mDpCk1APY.jpg\",\n \"created_at\": \"2012-11-03 19:26:10\",\n \"description\": \"A list of the films that were nominated at the 2010 Oscars for best picture.\",\n \"featured\": 0,\n \"id\": 8,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"2010 Oscar Nominations for Best Picture - 82nd Academy Awards\",\n \"number_of_items\": 10,\n \"poster_path\": \"/8iwe0iP49A6Gqcv31jBleZDZqI4.jpg\",\n \"public\": 1,\n \"revenue\": \"4678852580\",\n \"runtime\": 1207,\n \"sort_by\": 1,\n \"updated_at\": \"2020-05-14 16:28:43\"\n },\n {\n \"account_object_id\": \"4bc8892a017a3c0f92000002\",\n \"adult\": 0,\n \"average_rating\": 7.56359,\n \"backdrop_path\": \"/4Bb1kMIfrT2tYRZ9M6Jhqy6gkeF.jpg\",\n \"created_at\": \"2016-08-29 14:41:37\",\n \"description\": \"A list of the films that were nominated at the 2014 Oscars for best picture.\",\n \"featured\": 0,\n \"id\": 10288,\n \"iso_3166_1\": \"US\",\n \"iso_639_1\": \"en\",\n \"name\": \"2014 Oscar Nominations for Best Picture - 86th Academy Awards\",\n \"number_of_items\": 9,\n \"public\": 1,\n \"revenue\": \"1861899526\",\n \"runtime\": 1133,\n \"sort_by\": 1,\n \"updated_at\": \"2020-05-14 16:26:47\"\n }\n ],\n \"total_pages\": 2,\n \"total_results\": 25\n}" } }, "schema": { "type": "object", "properties": { "page": { "type": "integer", "example": 1, "default": 0 }, "results": { "type": "array", "items": { "type": "object", "properties": { "account_object_id": { "type": "string", "example": "4bc8892a017a3c0f92000002" }, "adult": { "type": "integer", "example": 0, "default": 0 }, "average_rating": { "type": "number", "example": 7.90183, "default": 0 }, "created_at": { "type": "string", "example": "2019-08-27 15:13:15" }, "description": { "type": "string", "example": "" }, "featured": { "type": "integer", "example": 0, "default": 0 }, "id": { "type": "integer", "example": 120174, "default": 0 }, "iso_3166_1": { "type": "string", "example": "US" }, "iso_639_1": { "type": "string", "example": "en" }, "name": { "type": "string", "example": "Test Alpha Sort" }, "number_of_items": { "type": "integer", "example": 6, "default": 0 }, "public": { "type": "integer", "example": 0, "default": 0 }, "revenue": { "type": "string", "example": "586453267" }, "runtime": { "type": "integer", "example": 644, "default": 0 }, "sort_by": { "type": "integer", "example": 7, "default": 0 }, "updated_at": { "type": "string", "example": "2023-05-05 16:49:11" } } } }, "total_pages": { "type": "integer", "example": 2, "default": 0 }, "total_results": { "type": "integer", "example": 25, "default": 0 } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```