> ## Documentation Index > Fetch the complete documentation index at: https://starlight.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Lists > This endpoint retrieves the list that the movie has been added to. ## OpenAPI ````yaml api-reference/openapi.yaml get /3/movie/{{movie_id}}/lists openapi: 3.0.3 info: title: The Movie Database API description: >- Welcome to the third version of The Movie Database (TMDB) API. Our API provides you with vast access to a range of movies, TV shows, actor information, and images. With the TMDB API, you can easily integrate any of these functionalities in your application. version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org - url: Collection security: - bearerAuth: [] tags: - name: Validate Key - name: Authentication - name: Guest Sessions - name: Configuration - name: Account - name: Search - name: Discover - name: Find - name: Keyword - name: Lists - name: V3 vs V4 description: >- There is version 4 (v4) for our list API. It contains several advanced improvements that differentiate it from the version 3 (v3) list. Although v3 lists will continue to work, you can only access these features if you switch to v4 lists. Some of the new improvements you can access on v4 lists include: - You can Import "unlimited" items in a single request - You can use mixed-type (movie and TV) lists - You can use private lists - You can add and use comments per item - There are more sort options - They are faster Check the v4 [documentation ](https://developer.themoviedb.org/v4/docs/getting-started) for more information. - name: Collections - name: Companies - name: Networks - name: Trending - name: Movies - name: Movie Lists - name: TV Series - name: TV Series Lists - name: TV Seasons - name: TV Providers - name: TV Episode Groups - name: Watch Providers - name: People - name: People List - name: Genre - name: Changes - name: Credits - name: Certifications paths: /3/movie/{{movie_id}}/lists: parameters: - name: movie_id in: path description: >- This represents the movie ID. Get it [here](https://starlight.mintlify.app/api-reference/movieid) required: true schema: type: string get: tags: - Movies summary: Lists description: This endpoint retrieves the list that the movie has been added to. operationId: lists1 parameters: - name: language in: query schema: type: string example: en description: This represents the movie language. - name: page in: query schema: type: string example: '1' description: This represents the page number. responses: '200': description: Lists headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=12347 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Tue, 24 Dec 2024 23:38:01 GMT ETag: schema: type: string example: W/"9b8e41fc3eb0b5b7c95ed7c000c5867a" 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 ffa4b37ccdc94a8c62bf6b6414725210.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: wQiRnLcOMwckMVV0sCVnzUQcY9tPeIe7Pej9JPpPP-FDMg_wGP9HQQ== 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: HIT x-memc-age: schema: type: string example: '14775' x-memc-expires: schema: type: string example: '12347' x-memc-key: schema: type: string example: 2379fa2d609f0951fa57bfd63b357a55 content: application/json: schema: type: object properties: id: type: number example: 845781 page: type: number example: 1 results: type: array items: type: object properties: description: type: string example: '' favorite_count: type: number example: 0 id: type: number example: 114281 iso_3166_1: type: string example: US iso_639_1: type: string example: en item_count: type: number example: 739 list_type: type: string example: movie name: type: string example: Dimshik movies watched 1501-2000 poster_path: nullable: true example: null example: - description: '' favorite_count: 0 id: 114281 iso_3166_1: US iso_639_1: en item_count: 739 list_type: movie name: Dimshik movies watched 1501-2000 poster_path: null - description: A list of mids found by Mid Hunters favorite_count: 0 id: 8272938 iso_3166_1: US iso_639_1: en item_count: 7422 list_type: movie name: Mid Hunting List poster_path: null - description: '' favorite_count: 0 id: 8503086 iso_3166_1: US iso_639_1: en item_count: 1 list_type: movie name: Ashik poster_path: null - description: Bing favorite_count: 0 id: 8501649 iso_3166_1: US iso_639_1: en item_count: 82 list_type: movie name: To Watch poster_path: null - description: Master List In Progress favorite_count: 0 id: 51108 iso_3166_1: US iso_639_1: en item_count: 11738 list_type: movie name: My Movies poster_path: null - description: '' favorite_count: 0 id: 8497887 iso_3166_1: US iso_639_1: en item_count: 19 list_type: movie name: Kids poster_path: null - description: "Trying to list the movies I have watched, but it may take quite some time to complete it.\r\n\r\nBy the way, I use MyAnimeList's notation system, which is:\r\n\r\n(1)\_Appalling; (2) Horrible; (3) Very Bad; (4) Bad; (5) Average; (6) Fine; (7) Good; (8) Very Good; (9) Great; (10) Masterpiece" favorite_count: 0 id: 8303328 iso_3166_1: US iso_639_1: en item_count: 176 list_type: movie name: WATCHED poster_path: null - description: >- primeVideo Top 10 Movies - Updated 2024-12-24T12:02:53.365-05:00 favorite_count: 0 id: 8302792 iso_3166_1: US iso_639_1: en item_count: 10 list_type: movie name: Top 10 Movies - Prime Video poster_path: null - description: '' favorite_count: 0 id: 8501709 iso_3166_1: US iso_639_1: en item_count: 27 list_type: movie name: nanaamoah poster_path: null - description: '' favorite_count: 0 id: 7111843 iso_3166_1: US iso_639_1: en item_count: 29 list_type: movie name: awk-player.watch-later-list.#preset_0 poster_path: null - description: '' favorite_count: 0 id: 8168597 iso_3166_1: US iso_639_1: en item_count: 15651 list_type: movie name: movies poster_path: null - description: '' favorite_count: 0 id: 8503062 iso_3166_1: US iso_639_1: en item_count: 2 list_type: movie name: trending poster_path: null - description: '' favorite_count: 0 id: 8230010 iso_3166_1: US iso_639_1: en item_count: 184 list_type: movie name: Christmas Movies poster_path: null - description: A list of my favorite movies favorite_count: 0 id: 8502419 iso_3166_1: US iso_639_1: en item_count: 1000 list_type: movie name: action poster_path: null - description: '' favorite_count: 0 id: 8256003 iso_3166_1: US iso_639_1: en item_count: 101 list_type: movie name: Christmas Movies poster_path: null - description: '' favorite_count: 0 id: 8501581 iso_3166_1: US iso_639_1: en item_count: 31 list_type: movie name: Tobhar poster_path: null - description: '' favorite_count: 0 id: 8501732 iso_3166_1: US iso_639_1: en item_count: 34 list_type: movie name: 'movie ' poster_path: null - description: '' favorite_count: 0 id: 8250820 iso_3166_1: US iso_639_1: en item_count: 693 list_type: movie name: watched poster_path: null - description: '' favorite_count: 0 id: 8285888 iso_3166_1: US iso_639_1: en item_count: 507 list_type: movie name: Watched 2024 - Movie Juice poster_path: null - description: A list of Movies running in Theaters favorite_count: 0 id: 63802 iso_3166_1: US iso_639_1: en item_count: 33 list_type: movie name: Now Running poster_path: null total_pages: type: number example: 10 total_results: type: number example: 197 examples: Lists: value: id: 845781 page: 1 results: - description: '' favorite_count: 0 id: 114281 iso_3166_1: US iso_639_1: en item_count: 739 list_type: movie name: Dimshik movies watched 1501-2000 poster_path: null - description: A list of mids found by Mid Hunters favorite_count: 0 id: 8272938 iso_3166_1: US iso_639_1: en item_count: 7422 list_type: movie name: Mid Hunting List poster_path: null - description: '' favorite_count: 0 id: 8503086 iso_3166_1: US iso_639_1: en item_count: 1 list_type: movie name: Ashik poster_path: null - description: Bing favorite_count: 0 id: 8501649 iso_3166_1: US iso_639_1: en item_count: 82 list_type: movie name: To Watch poster_path: null - description: Master List In Progress favorite_count: 0 id: 51108 iso_3166_1: US iso_639_1: en item_count: 11738 list_type: movie name: My Movies poster_path: null - description: '' favorite_count: 0 id: 8497887 iso_3166_1: US iso_639_1: en item_count: 19 list_type: movie name: Kids poster_path: null - description: "Trying to list the movies I have watched, but it may take quite some time to complete it.\r\n\r\nBy the way, I use MyAnimeList's notation system, which is:\r\n\r\n(1)\_Appalling; (2) Horrible; (3) Very Bad; (4) Bad; (5) Average; (6) Fine; (7) Good; (8) Very Good; (9) Great; (10) Masterpiece" favorite_count: 0 id: 8303328 iso_3166_1: US iso_639_1: en item_count: 176 list_type: movie name: WATCHED poster_path: null - description: >- primeVideo Top 10 Movies - Updated 2024-12-24T12:02:53.365-05:00 favorite_count: 0 id: 8302792 iso_3166_1: US iso_639_1: en item_count: 10 list_type: movie name: Top 10 Movies - Prime Video poster_path: null - description: '' favorite_count: 0 id: 8501709 iso_3166_1: US iso_639_1: en item_count: 27 list_type: movie name: nanaamoah poster_path: null - description: '' favorite_count: 0 id: 7111843 iso_3166_1: US iso_639_1: en item_count: 29 list_type: movie name: awk-player.watch-later-list.#preset_0 poster_path: null - description: '' favorite_count: 0 id: 8168597 iso_3166_1: US iso_639_1: en item_count: 15651 list_type: movie name: movies poster_path: null - description: '' favorite_count: 0 id: 8503062 iso_3166_1: US iso_639_1: en item_count: 2 list_type: movie name: trending poster_path: null - description: '' favorite_count: 0 id: 8230010 iso_3166_1: US iso_639_1: en item_count: 184 list_type: movie name: Christmas Movies poster_path: null - description: A list of my favorite movies favorite_count: 0 id: 8502419 iso_3166_1: US iso_639_1: en item_count: 1000 list_type: movie name: action poster_path: null - description: '' favorite_count: 0 id: 8256003 iso_3166_1: US iso_639_1: en item_count: 101 list_type: movie name: Christmas Movies poster_path: null - description: '' favorite_count: 0 id: 8501581 iso_3166_1: US iso_639_1: en item_count: 31 list_type: movie name: Tobhar poster_path: null - description: '' favorite_count: 0 id: 8501732 iso_3166_1: US iso_639_1: en item_count: 34 list_type: movie name: 'movie ' poster_path: null - description: '' favorite_count: 0 id: 8250820 iso_3166_1: US iso_639_1: en item_count: 693 list_type: movie name: watched poster_path: null - description: '' favorite_count: 0 id: 8285888 iso_3166_1: US iso_639_1: en item_count: 507 list_type: movie name: Watched 2024 - Movie Juice poster_path: null - description: A list of Movies running in Theaters favorite_count: 0 id: 63802 iso_3166_1: US iso_639_1: en item_count: 33 list_type: movie name: Now Running poster_path: null total_pages: 10 total_results: 197 components: securitySchemes: bearerAuth: type: http scheme: bearer ````