> ## Documentation Index > Fetch the complete documentation index at: https://sirjosh.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Lists > This endpoint get a users list of custom lists. ## OpenAPI ````yaml api-reference/openapi3.json get /3/account/{account_id}/lists openapi: 3.0.3 info: title: The Movie Database version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - bearerAuth: [] tags: - name: AUTHENTICATION - name: ACCOUNT - name: CERTIFICATIONS - name: CHANGES - name: COLLECTIONS - name: COMPANY - name: CONFIGURATION - name: CREDIT - name: DISCOVER - name: FIND - name: GENRES - name: GUEST SESSIONS - name: KEYWORDS - name: LISTS - name: MOVIE LISTS - name: MOVIES - name: NETWORKS - name: PEOPLE LIST - name: PEOPLE - name: REVIEWS - name: SEARCH - name: TRENDING - name: TV SERIES LIST - name: TV SERIES - name: TV SEASONS - name: TV EPISODES - name: TV EPISODE GROUP - name: WATCH PROVIDERS paths: /3/account/{account_id}/lists: get: tags: - ACCOUNT summary: Lists description: This endpoint get a users list of custom lists. operationId: lists parameters: - $ref: '#/components/parameters/page' - $ref: '#/components/parameters/session_id' - $ref: '#/components/parameters/account_id' responses: '200': description: lists headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=0 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Mon, 16 Dec 2024 15:00:15 GMT ETag: schema: type: string example: W/"5b333525ff117973180331432dc740b8" Server: schema: type: string example: openresty Transfer-Encoding: schema: type: string example: chunked Vary: schema: type: string example: Origin Via: schema: type: string example: >- 1.1 20f0d9cf6610f77242f5c592d2ecfd1c.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: wAQloToE_s0xkEk5_CYeqqEIPRvujaPnxHxfd9GWDsebzDMCRsr_sA== X-Amz-Cf-Pop: schema: type: string example: IAD89-C3 X-Cache: schema: type: string example: Miss from cloudfront x-memc: schema: type: string example: MISS x-memc-age: schema: type: string example: '0' x-memc-expires: schema: type: string example: '0' x-memc-key: schema: type: string example: 208bf88ef35ae1f415fbf6b385484f09 content: application/json: schema: type: object properties: page: type: number example: 1 description: >- Represents the current page of the results being returned. It starts from 1 and increments with each new page. results: type: array items: type: object properties: description: type: string example: '' description: >- A textual description of the movie list. It provides additional context or insights about the movies in the list favorite_count: type: number example: 0 description: >- The number of users who have marked this list as a favorite. A count of 0 indicates no users have favorited it. id: type: number example: 120174 description: >- A unique identifier for each movie list. It is used for referencing or accessing specific lists in the database. iso_639_1: type: string example: en description: >- A code representing the language of the list (ISO 639-1 format). In this case, "en" indicates that the list is in English. item_count: type: number example: 5 description: >- The number of items (movies) included in this particular list. This gives an indication of the size of the list. list_type: type: string example: movie description: >- Denotes the type of the list. In this case, it is set to "movie", indicating that the list comprises movies. name: type: string example: Test Alpha Sort description: >- The title of the movie list, indicating the theme or focus of the collection. poster_path: type: string nullable: true example: null description: >- A relative path to the poster image associated with the list. If null, it indicates that no poster image is available. example: - description: '' favorite_count: 0 id: 120174 iso_639_1: en item_count: 5 list_type: movie name: Test Alpha Sort poster_path: null - description: '' favorite_count: 0 id: 8221116 iso_639_1: en item_count: 4 list_type: movie name: Test List poster_path: null - description: >- Here's a list of the films that take place in the DC Comics universe. favorite_count: 0 id: 3 iso_639_1: en item_count: 30 list_type: movie name: The DC Comics Universe poster_path: /4H1jWsgEQOgTs4KeG5j5BorKMfX.jpg - description: This is a test. favorite_count: 0 id: 8212330 iso_639_1: en item_count: 2 list_type: movie name: 'Test List #1' poster_path: null - description: Just a UTF test list. 🍩 🐝 favorite_count: 0 id: 7066467 iso_639_1: en item_count: 3 list_type: movie name: 🚨 My Cool List! poster_path: null - description: >- The idea behind this list is to collect the live action comic book movies from within the Marvel franchise. favorite_count: 0 id: 1 iso_639_1: en item_count: 59 list_type: movie name: The Marvel Universe poster_path: /coJVIUEOToAEGViuhclM7pXC75R.jpg - description: Test description. favorite_count: 0 id: 136203 iso_639_1: en item_count: 2 list_type: movie name: Test From Trav's Scripts poster_path: null - description: '' favorite_count: 0 id: 142798 iso_639_1: en item_count: 3 list_type: movie name: UFC Test poster_path: null - description: >- A list of the films that were nominated at the 2012 Oscars for best picture. favorite_count: 0 id: 2 iso_639_1: en item_count: 9 list_type: movie name: >- 2012 Oscar Nominations for Best Picture - 84th Academy Awards poster_path: /zRqBleU93WncYnIwt8LAanQerZ7.jpg - description: >- Here are the films that have won for best drama at the Golden Globes. favorite_count: 0 id: 2469 iso_639_1: en item_count: 63 list_type: movie name: Best Picture Winners - The Golden Globes poster_path: /zkjL4XYZkbSKPYJgK1goBYS9EVN.jpg - description: >- Name pretty much says it all, here's the top 50 grossing films of all time. favorite_count: 0 id: 10 iso_639_1: en item_count: 50 list_type: movie name: Top 50 Grossing Films of All Time (Worldwide) poster_path: /sRbZeVtRKIWybTOVpCRPZtzW5bd.jpg - description: >- A list of the films that were nominated at the 2013 Oscars for best picture. favorite_count: 0 id: 2278 iso_639_1: en item_count: 9 list_type: movie name: >- 2013 Oscar Nominations for Best Picture - 85th Academy Awards poster_path: /AfyPUSSn7E75daZ3SfENRbA25h9.jpg - description: >- A list of the theatrical releases for Marvel's Avengers characters that are in the latest Avengers movie. favorite_count: 0 id: 5 iso_639_1: en item_count: 10 list_type: movie name: The Avengers poster_path: /2i89ujVkhJebuoB2zy6QZcwbr2N.jpg - description: >- A list of the films that were nominated at the 2008 Oscars for best picture. favorite_count: 0 id: 27 iso_639_1: en item_count: 5 list_type: movie name: >- 2008 Oscar Nominations for Best Picture - 80th Academy Awards poster_path: /nWwFabqFaBbukXdkUCmtnrFxPNh.jpg - 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. favorite_count: 0 id: 15 iso_639_1: en item_count: 6 list_type: movie name: The View Askewniverse poster_path: /tGmU66LL8edoRm1RO7sbrz1xuhr.jpg - description: >- A list of the films that were nominated at the 2009 Oscars for best picture. favorite_count: 0 id: 9 iso_639_1: en item_count: 5 list_type: movie name: >- 2009 Oscar Nominations for Best Picture - 81st Academy Awards poster_path: /gShtwIvdSHgCEQRZfymNkEUEwFm.jpg - description: >- A list of the films that were nominated at the 2016 Oscars for best picture. favorite_count: 0 id: 10291 iso_639_1: en item_count: 8 list_type: movie name: >- 2016 Oscar Nominations for Best Picture - 88th Academy Awards poster_path: null - description: >- A list of the films that were nominated at the 2011 Oscars for best picture. favorite_count: 0 id: 4 iso_639_1: en item_count: 10 list_type: movie name: >- 2011 Oscar Nominations for Best Picture - 83rd Academy Awards poster_path: /iAHDZPyLD3NW7GuNV6U1TVtb0hN.jpg - description: >- A list of the films that were nominated at the 2010 Oscars for best picture. favorite_count: 0 id: 8 iso_639_1: en item_count: 10 list_type: movie name: >- 2010 Oscar Nominations for Best Picture - 82nd Academy Awards poster_path: /8iwe0iP49A6Gqcv31jBleZDZqI4.jpg - description: >- A list of the films that were nominated at the 2014 Oscars for best picture. favorite_count: 0 id: 10288 iso_639_1: en item_count: 9 list_type: movie name: >- 2014 Oscar Nominations for Best Picture - 86th Academy Awards poster_path: null description: >- This represents a collection of movie objects returned by the API that provides information about various films. total_pages: type: number example: 2 description: The total number of pages available for the query results. total_results: type: number example: 25 description: >- The total number of results that meet the criteria of the query. examples: lists: value: page: 1 results: - description: '' favorite_count: 0 id: 120174 iso_639_1: en item_count: 5 list_type: movie name: Test Alpha Sort poster_path: null - description: '' favorite_count: 0 id: 8221116 iso_639_1: en item_count: 4 list_type: movie name: Test List poster_path: null - description: >- Here's a list of the films that take place in the DC Comics universe. favorite_count: 0 id: 3 iso_639_1: en item_count: 30 list_type: movie name: The DC Comics Universe poster_path: /4H1jWsgEQOgTs4KeG5j5BorKMfX.jpg - description: This is a test. favorite_count: 0 id: 8212330 iso_639_1: en item_count: 2 list_type: movie name: 'Test List #1' poster_path: null - description: Just a UTF test list. 🍩 🐝 favorite_count: 0 id: 7066467 iso_639_1: en item_count: 3 list_type: movie name: 🚨 My Cool List! poster_path: null - description: >- The idea behind this list is to collect the live action comic book movies from within the Marvel franchise. favorite_count: 0 id: 1 iso_639_1: en item_count: 59 list_type: movie name: The Marvel Universe poster_path: /coJVIUEOToAEGViuhclM7pXC75R.jpg - description: Test description. favorite_count: 0 id: 136203 iso_639_1: en item_count: 2 list_type: movie name: Test From Trav's Scripts poster_path: null - description: '' favorite_count: 0 id: 142798 iso_639_1: en item_count: 3 list_type: movie name: UFC Test poster_path: null - description: >- A list of the films that were nominated at the 2012 Oscars for best picture. favorite_count: 0 id: 2 iso_639_1: en item_count: 9 list_type: movie name: >- 2012 Oscar Nominations for Best Picture - 84th Academy Awards poster_path: /zRqBleU93WncYnIwt8LAanQerZ7.jpg - description: >- Here are the films that have won for best drama at the Golden Globes. favorite_count: 0 id: 2469 iso_639_1: en item_count: 63 list_type: movie name: Best Picture Winners - The Golden Globes poster_path: /zkjL4XYZkbSKPYJgK1goBYS9EVN.jpg - description: >- Name pretty much says it all, here's the top 50 grossing films of all time. favorite_count: 0 id: 10 iso_639_1: en item_count: 50 list_type: movie name: Top 50 Grossing Films of All Time (Worldwide) poster_path: /sRbZeVtRKIWybTOVpCRPZtzW5bd.jpg - description: >- A list of the films that were nominated at the 2013 Oscars for best picture. favorite_count: 0 id: 2278 iso_639_1: en item_count: 9 list_type: movie name: >- 2013 Oscar Nominations for Best Picture - 85th Academy Awards poster_path: /AfyPUSSn7E75daZ3SfENRbA25h9.jpg - description: >- A list of the theatrical releases for Marvel's Avengers characters that are in the latest Avengers movie. favorite_count: 0 id: 5 iso_639_1: en item_count: 10 list_type: movie name: The Avengers poster_path: /2i89ujVkhJebuoB2zy6QZcwbr2N.jpg - description: >- A list of the films that were nominated at the 2008 Oscars for best picture. favorite_count: 0 id: 27 iso_639_1: en item_count: 5 list_type: movie name: >- 2008 Oscar Nominations for Best Picture - 80th Academy Awards poster_path: /nWwFabqFaBbukXdkUCmtnrFxPNh.jpg - 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. favorite_count: 0 id: 15 iso_639_1: en item_count: 6 list_type: movie name: The View Askewniverse poster_path: /tGmU66LL8edoRm1RO7sbrz1xuhr.jpg - description: >- A list of the films that were nominated at the 2009 Oscars for best picture. favorite_count: 0 id: 9 iso_639_1: en item_count: 5 list_type: movie name: >- 2009 Oscar Nominations for Best Picture - 81st Academy Awards poster_path: /gShtwIvdSHgCEQRZfymNkEUEwFm.jpg - description: >- A list of the films that were nominated at the 2016 Oscars for best picture. favorite_count: 0 id: 10291 iso_639_1: en item_count: 8 list_type: movie name: >- 2016 Oscar Nominations for Best Picture - 88th Academy Awards poster_path: null - description: >- A list of the films that were nominated at the 2011 Oscars for best picture. favorite_count: 0 id: 4 iso_639_1: en item_count: 10 list_type: movie name: >- 2011 Oscar Nominations for Best Picture - 83rd Academy Awards poster_path: /iAHDZPyLD3NW7GuNV6U1TVtb0hN.jpg - description: >- A list of the films that were nominated at the 2010 Oscars for best picture. favorite_count: 0 id: 8 iso_639_1: en item_count: 10 list_type: movie name: >- 2010 Oscar Nominations for Best Picture - 82nd Academy Awards poster_path: /8iwe0iP49A6Gqcv31jBleZDZqI4.jpg - description: >- A list of the films that were nominated at the 2014 Oscars for best picture. favorite_count: 0 id: 10288 iso_639_1: en item_count: 9 list_type: movie name: >- 2014 Oscar Nominations for Best Picture - 86th Academy Awards poster_path: null total_pages: 2 total_results: 25 components: parameters: page: name: page in: query description: >- Indicates which page of results to return. Default is the first page (1). schema: type: integer example: 1 session_id: name: session_id in: query description: >- A token that represents a logged-in user's session after they have authenticated with their TMDB account. schema: type: string example: '' account_id: name: account_id in: path required: true description: This refers to a unique identifier assigned to a user account. schema: type: integer example: '' securitySchemes: bearerAuth: type: http scheme: bearer ````