> ## 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 TV series has been added to. ## OpenAPI ````yaml api-reference/TMDB.json get /3/tv/{series_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/tv/{series_id}/lists: get: tags: - TV Series summary: Lists description: >- This endpoint is used to get the lists that a TV series has been added to. operationId: lists2 parameters: - name: series_id in: path required: true schema: type: string example: '4614' 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=24178 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Wed, 18 Dec 2024 15:27:23 GMT ETag: schema: type: string example: W/"55cfaff73834fbd0f9795395d082012a" 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 51391527dd8c879c45b44b119905c872.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: RZ5qpAq6X1JGjw7vnXDzpy1nzkMasl7lB83QjaLUjbuGcgu2b7zf-A== 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, STORE x-memc-age: schema: type: string example: '0' x-memc-expires: schema: type: string example: '24178' x-memc-key: schema: type: string example: 200d5d815b1a86e05b796977abb9a066 content: application/json: schema: type: object properties: id: type: number example: 4614 page: type: number example: 1 results: type: array items: type: object properties: description: type: string example: >- paramount Top 10 TV Shows - Updated 2024-12-18T09:01:31.823-05:00 favorite_count: type: number example: 0 id: type: number example: 8303423 iso_3166_1: type: string example: US iso_639_1: type: string example: en item_count: type: number example: 10 name: type: string example: Top 10 TV Shows - Paramount+ poster_path: type: string nullable: true example: null example: - description: >- paramount Top 10 TV Shows - Updated 2024-12-18T09:01:31.823-05:00 favorite_count: 0 id: 8303423 iso_3166_1: US iso_639_1: en item_count: 10 name: Top 10 TV Shows - Paramount+ poster_path: null - description: '' favorite_count: 0 id: 8501510 iso_3166_1: US iso_639_1: en item_count: 8 name: 'watch ' poster_path: null - description: '' favorite_count: 0 id: 134725 iso_3166_1: US iso_639_1: en item_count: 998 name: Watched Movies poster_path: null - description: '' favorite_count: 0 id: 8501234 iso_3166_1: US iso_639_1: en item_count: 12 name: New Shows (Since 2020) poster_path: null - description: '' favorite_count: 0 id: 6608629 iso_3166_1: US iso_639_1: en item_count: 4034 name: Emmy Award Nominated Titles - IMDb poster_path: null - description: Movies and TV shows I physically own. favorite_count: 0 id: 23932 iso_3166_1: US iso_639_1: en item_count: 1039 name: My DVD/BD Collection poster_path: null - description: "TV SERIES BALISTAR LIST\r\nJl. Sahadewa No.13C, Legian, Kec kuta, Kabupaten Badung, Bali. “In front of The Local Restaurant”" favorite_count: 0 id: 8226356 iso_3166_1: US iso_639_1: en item_count: 2309 name: TV SERIES 2024 UPDATE poster_path: null - description: '' favorite_count: 0 id: 8231754 iso_3166_1: US iso_639_1: en item_count: 248 name: TV Series poster_path: null - description: '' favorite_count: 0 id: 7102892 iso_3166_1: US iso_639_1: en item_count: 1261 name: Promote Black Filmmakers®™ Playlist poster_path: null - description: tv favorite_count: 0 id: 8281520 iso_3166_1: US iso_639_1: en item_count: 88 name: Sonarr poster_path: null - description: '' favorite_count: 0 id: 146589 iso_3166_1: US iso_639_1: en item_count: 3773 name: RecentMovieShow poster_path: null - description: 'Serie ' favorite_count: 0 id: 144184 iso_3166_1: US iso_639_1: en item_count: 639 name: Serie1 poster_path: null - description: W L favorite_count: 0 id: 8222038 iso_3166_1: US iso_639_1: en item_count: 1807 name: R-C |•| P-M/S poster_path: null - description: >- Six television series make up the NCIS franchise: NCIS, Los Angeles, New Orleans, Hawaiʻi, Sydney, and Origins. favorite_count: 0 id: 8454723 iso_3166_1: US iso_639_1: en item_count: 6 name: The NCISverse poster_path: null - description: '' favorite_count: 0 id: 7074347 iso_3166_1: US iso_639_1: en item_count: 67 name: TV SERIES TMDB poster_path: null - description: '' favorite_count: 0 id: 8237878 iso_3166_1: US iso_639_1: en item_count: 395 name: NewTV poster_path: null - description: '' favorite_count: 0 id: 8312044 iso_3166_1: US iso_639_1: en item_count: 54 name: Iconic poster_path: null - description: '' favorite_count: 0 id: 895 iso_3166_1: US iso_639_1: en item_count: 95 name: Drama poster_path: /l1DYmEw99vBGcAjwQLh0WruAUhW.jpg - description: '' favorite_count: 0 id: 8310018 iso_3166_1: US iso_639_1: en item_count: 1 name: My Favs poster_path: null - description: '' favorite_count: 0 id: 8308052 iso_3166_1: US iso_639_1: en item_count: 38 name: Action poster_path: null total_pages: type: number example: 23 total_results: type: number example: 442 examples: OK: value: id: 4614 page: 1 results: - description: >- paramount Top 10 TV Shows - Updated 2024-12-18T09:01:31.823-05:00 favorite_count: 0 id: 8303423 iso_3166_1: US iso_639_1: en item_count: 10 name: Top 10 TV Shows - Paramount+ poster_path: null - description: '' favorite_count: 0 id: 8501510 iso_3166_1: US iso_639_1: en item_count: 8 name: 'watch ' poster_path: null - description: '' favorite_count: 0 id: 134725 iso_3166_1: US iso_639_1: en item_count: 998 name: Watched Movies poster_path: null - description: '' favorite_count: 0 id: 8501234 iso_3166_1: US iso_639_1: en item_count: 12 name: New Shows (Since 2020) poster_path: null - description: '' favorite_count: 0 id: 6608629 iso_3166_1: US iso_639_1: en item_count: 4034 name: Emmy Award Nominated Titles - IMDb poster_path: null - description: Movies and TV shows I physically own. favorite_count: 0 id: 23932 iso_3166_1: US iso_639_1: en item_count: 1039 name: My DVD/BD Collection poster_path: null - description: "TV SERIES BALISTAR LIST\r\nJl. Sahadewa No.13C, Legian, Kec kuta, Kabupaten Badung, Bali. “In front of The Local Restaurant”" favorite_count: 0 id: 8226356 iso_3166_1: US iso_639_1: en item_count: 2309 name: TV SERIES 2024 UPDATE poster_path: null - description: '' favorite_count: 0 id: 8231754 iso_3166_1: US iso_639_1: en item_count: 248 name: TV Series poster_path: null - description: '' favorite_count: 0 id: 7102892 iso_3166_1: US iso_639_1: en item_count: 1261 name: Promote Black Filmmakers®™ Playlist poster_path: null - description: tv favorite_count: 0 id: 8281520 iso_3166_1: US iso_639_1: en item_count: 88 name: Sonarr poster_path: null - description: '' favorite_count: 0 id: 146589 iso_3166_1: US iso_639_1: en item_count: 3773 name: RecentMovieShow poster_path: null - description: 'Serie ' favorite_count: 0 id: 144184 iso_3166_1: US iso_639_1: en item_count: 639 name: Serie1 poster_path: null - description: W L favorite_count: 0 id: 8222038 iso_3166_1: US iso_639_1: en item_count: 1807 name: R-C |•| P-M/S poster_path: null - description: >- Six television series make up the NCIS franchise: NCIS, Los Angeles, New Orleans, Hawaiʻi, Sydney, and Origins. favorite_count: 0 id: 8454723 iso_3166_1: US iso_639_1: en item_count: 6 name: The NCISverse poster_path: null - description: '' favorite_count: 0 id: 7074347 iso_3166_1: US iso_639_1: en item_count: 67 name: TV SERIES TMDB poster_path: null - description: '' favorite_count: 0 id: 8237878 iso_3166_1: US iso_639_1: en item_count: 395 name: NewTV poster_path: null - description: '' favorite_count: 0 id: 8312044 iso_3166_1: US iso_639_1: en item_count: 54 name: Iconic poster_path: null - description: '' favorite_count: 0 id: 895 iso_3166_1: US iso_639_1: en item_count: 95 name: Drama poster_path: /l1DYmEw99vBGcAjwQLh0WruAUhW.jpg - description: '' favorite_count: 0 id: 8310018 iso_3166_1: US iso_639_1: en item_count: 1 name: My Favs poster_path: null - description: '' favorite_count: 0 id: 8308052 iso_3166_1: US iso_639_1: en item_count: 38 name: Action poster_path: null total_pages: 23 total_results: 442 components: securitySchemes: apikey: type: apiKey name: '{{key}}' in: query ````