> ## Documentation Index > Fetch the complete documentation index at: https://iqma-31aad55c.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Lists > This endpoint is used to get the lists that a movie has been added to. ## OpenAPI ````yaml api-reference/TMDB.json get /3/movie/{movie_id}/lists openapi: 3.0.3 info: title: The Movie Database description: "# About\n\nThe Movie Database (TMDB) is a _community built_ movie and TV database. Every piece of data has been added by our amazing community dating back to 2008. TMDB's strong _international focus_ and breadth of data is largely unmatched and something we're incredibly proud of\n\nAlong with extensive metadata for movies, TV shows and people, we also offer one of the best selections of high resolution posters and backdrops. On average, over 1,000 images are added every single day.\n\n# Getting Started\n\nWelcome to version 3 (v3) of Ihe Movie Database(TMDB)API. This documentation serves as a guide to kick- start your experience with the world's largest movie database,\_Operating under the REST architecture. this API has become familiar to developers over the years, owing to its resemblance to the well-known web request and response pattern and its utillization of JSON as the preferred syntax for delivering responses.\n\nHere, you'll find information on all your favorite movies, including ratings, release dates, and much more. However, before you begin, be sure to explore the introductory pages, which include the Authentication page and the Errors & status code page.\_\n\n# Authentication \n\nBefore you can use the TMBD API, you need to generate your API Key - which is how you authenticate with the API.\nTo get an API key, you need to sign up at the officlal TMDB homepage. To do sign up, follow the steps below\_\n\n1. Navigate to the TMBD sign up page.\n\n2. After submitting your requested details, verify your account to login.\n3. Once you are logged in, you can now access your profile page containing information such as your most watched genres, and other recent activities.\n4. At the right corner of your profile page, navigate to your profile avatar and select the Settings options.\n5. On the settings page, navigate to the API option at the left corner menu.\n6. From the following options, chose the plan that suits you, The options include Developer and Professional. Both plans have their advantages listed below them.\n7.\_Once you select a plan, you'll fill out the form which would collect information about the API usage. information requested would include name of applicaton, it's url, etc.\n8. Once completed, you would be redirected to a new page where you'll see your generated API Key, Or check the notification icon for an instant message delivering your API key with additional informatian on the next steps to take." version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - apikey: [] tags: - name: Getting Started - name: Account description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Authentication description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Certifications - name: Changes - name: Collections description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Companies - name: Configuration - name: Credits description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Discover - name: Find description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Genres - name: Keywords description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Lists description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Movie Lists description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Movies description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Networks description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: People Lists - name: People description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Reviews description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Search - name: Trending - name: TV Series Lists - name: TV Series description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: TV Seasons - name: TV Episodes - name: TV Episode Groups description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Watch Provider paths: /3/movie/{movie_id}/lists: get: tags: - Movies summary: Lists description: This endpoint is used to get the lists that a movie has been added to. operationId: lists1 parameters: - name: movie_id in: path required: true schema: type: string example: '1241982' description: integer responses: '200': description: OK headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=11629 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Tue, 17 Dec 2024 15:13:51 GMT ETag: schema: type: string example: W/"6b80899e71c16194171ba719fcf8aac5" 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 c84ecfd128e1f4c41a53a2b42410f3b8.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: oK0DduzLL6cE9M-ghuwy0r9fk_Rv0MFG1kfrVy-f5wt1fQ9apKQTRg== 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: '12171' x-memc-expires: schema: type: string example: '11629' x-memc-key: schema: type: string example: 6a76ee98ea1a28e0c94943963ec26abf content: application/json: schema: type: object properties: id: type: number example: 1241982 page: type: number example: 1 results: type: array items: type: object properties: description: type: string example: familly favorite_count: type: number example: 0 id: type: number example: 8501472 iso_3166_1: type: string example: US iso_639_1: type: string example: en item_count: type: number example: 1 list_type: type: string example: movie name: type: string example: anime poster_path: nullable: true example: null example: - description: familly favorite_count: 0 id: 8501472 iso_3166_1: US iso_639_1: en item_count: 1 list_type: movie name: anime poster_path: null - description: '' favorite_count: 0 id: 8293545 iso_3166_1: US iso_639_1: en item_count: 20 list_type: movie name: Filmy poster_path: null - description: '' favorite_count: 0 id: 8289773 iso_3166_1: US iso_639_1: en item_count: 1003 list_type: movie name: Founders WW poster_path: null - description: asdasdasd favorite_count: 0 id: 8487431 iso_3166_1: US iso_639_1: en item_count: 4 list_type: movie name: dasdasd poster_path: null - description: newst list favorite_count: 0 id: 8499713 iso_3166_1: US iso_639_1: en item_count: 4 list_type: movie name: new list poster_path: null - description: Just an awesome list. favorite_count: 0 id: 8499712 iso_3166_1: US iso_639_1: en item_count: 4 list_type: movie name: This is my awesome test list. poster_path: null - description: movies to get favorite_count: 0 id: 8499772 iso_3166_1: US iso_639_1: en item_count: 28 list_type: movie name: Movies to get poster_path: null - description: 2024 Movies favorite_count: 0 id: 8495794 iso_3166_1: US iso_639_1: en item_count: 84 list_type: movie name: 2024 Movies poster_path: null - description: '' favorite_count: 0 id: 8287840 iso_3166_1: US iso_639_1: en item_count: 23 list_type: movie name: '2024 Kids Movies ' poster_path: null - description: Ma liste de favoris favorite_count: 0 id: 8426970 iso_3166_1: US iso_639_1: en item_count: 5 list_type: movie name: Favoris poster_path: null - description: List of movies for my server favorite_count: 0 id: 7108109 iso_3166_1: US iso_639_1: en item_count: 119 list_type: movie name: Movie Request List 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: 52 list_type: movie name: Now Running poster_path: null - description: '' favorite_count: 0 id: 8234063 iso_3166_1: US iso_639_1: en item_count: 4886 list_type: movie name: Favorite Actors poster_path: null - description: '' favorite_count: 0 id: 8297247 iso_3166_1: US iso_639_1: en item_count: 168 list_type: movie name: Library poster_path: null - description: '' favorite_count: 0 id: 103747 iso_3166_1: US iso_639_1: en item_count: 1290 list_type: movie name: Grandma poster_path: null - description: '' favorite_count: 0 id: 8307167 iso_3166_1: US iso_639_1: en item_count: 30 list_type: movie name: Trending Movies poster_path: null - description: '' favorite_count: 0 id: 129316 iso_3166_1: US iso_639_1: en item_count: 345 list_type: movie name: Want poster_path: null - description: Super Watchlist favorite_count: 0 id: 8501153 iso_3166_1: US iso_639_1: en item_count: 6 list_type: movie name: π™’π˜Όπ™π˜Ύπ™ƒπ™‡π™„π™Žπ™ poster_path: null - description: '' favorite_count: 0 id: 8274484 iso_3166_1: US iso_639_1: en item_count: 17 list_type: movie name: Watchlist poster_path: null - description: '' favorite_count: 0 id: 116928 iso_3166_1: US iso_639_1: en item_count: 552 list_type: movie name: RADARR poster_path: null total_pages: type: number example: 7 total_results: type: number example: 128 examples: OK: value: id: 1241982 page: 1 results: - description: familly favorite_count: 0 id: 8501472 iso_3166_1: US iso_639_1: en item_count: 1 list_type: movie name: anime poster_path: null - description: '' favorite_count: 0 id: 8293545 iso_3166_1: US iso_639_1: en item_count: 20 list_type: movie name: Filmy poster_path: null - description: '' favorite_count: 0 id: 8289773 iso_3166_1: US iso_639_1: en item_count: 1003 list_type: movie name: Founders WW poster_path: null - description: asdasdasd favorite_count: 0 id: 8487431 iso_3166_1: US iso_639_1: en item_count: 4 list_type: movie name: dasdasd poster_path: null - description: newst list favorite_count: 0 id: 8499713 iso_3166_1: US iso_639_1: en item_count: 4 list_type: movie name: new list poster_path: null - description: Just an awesome list. favorite_count: 0 id: 8499712 iso_3166_1: US iso_639_1: en item_count: 4 list_type: movie name: This is my awesome test list. poster_path: null - description: movies to get favorite_count: 0 id: 8499772 iso_3166_1: US iso_639_1: en item_count: 28 list_type: movie name: Movies to get poster_path: null - description: 2024 Movies favorite_count: 0 id: 8495794 iso_3166_1: US iso_639_1: en item_count: 84 list_type: movie name: 2024 Movies poster_path: null - description: '' favorite_count: 0 id: 8287840 iso_3166_1: US iso_639_1: en item_count: 23 list_type: movie name: '2024 Kids Movies ' poster_path: null - description: Ma liste de favoris favorite_count: 0 id: 8426970 iso_3166_1: US iso_639_1: en item_count: 5 list_type: movie name: Favoris poster_path: null - description: List of movies for my server favorite_count: 0 id: 7108109 iso_3166_1: US iso_639_1: en item_count: 119 list_type: movie name: Movie Request List 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: 52 list_type: movie name: Now Running poster_path: null - description: '' favorite_count: 0 id: 8234063 iso_3166_1: US iso_639_1: en item_count: 4886 list_type: movie name: Favorite Actors poster_path: null - description: '' favorite_count: 0 id: 8297247 iso_3166_1: US iso_639_1: en item_count: 168 list_type: movie name: Library poster_path: null - description: '' favorite_count: 0 id: 103747 iso_3166_1: US iso_639_1: en item_count: 1290 list_type: movie name: Grandma poster_path: null - description: '' favorite_count: 0 id: 8307167 iso_3166_1: US iso_639_1: en item_count: 30 list_type: movie name: Trending Movies poster_path: null - description: '' favorite_count: 0 id: 129316 iso_3166_1: US iso_639_1: en item_count: 345 list_type: movie name: Want poster_path: null - description: Super Watchlist favorite_count: 0 id: 8501153 iso_3166_1: US iso_639_1: en item_count: 6 list_type: movie name: π™’π˜Όπ™π˜Ύπ™ƒπ™‡π™„π™Žπ™ poster_path: null - description: '' favorite_count: 0 id: 8274484 iso_3166_1: US iso_639_1: en item_count: 17 list_type: movie name: Watchlist poster_path: null - description: '' favorite_count: 0 id: 116928 iso_3166_1: US iso_639_1: en item_count: 552 list_type: movie name: RADARR poster_path: null total_pages: 7 total_results: 128 components: securitySchemes: apikey: type: apiKey name: '{{key}}' in: query ````