> ## Documentation Index > Fetch the complete documentation index at: https://chisa.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Lists > Get the lists that a TV series has been added to. ## OpenAPI ````yaml api-reference/openapi.json get /3/tv/{{series_id}}/lists openapi: 3.0.3 info: title: Themoviedb API description: >- Version 3 (stable) of The Movie Database (TMDB) API offers a concise list of available methods for movies, TV shows, actors, and images. version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org - url: https://api.themoviedb.org/3 security: [] tags: - name: Account - name: Authentication description: >- # How do I generate a session id? As outlined in the [getting started guide](https://developer.themoviedb.org/docs/getting-started), the basics to getting a user authenticated look like this: 1. **Create a new request token** 2. **Get the user to authorize the request token** 3. **Create a new session id with the authorized request token** Steps 1 and 3 should be fairly easy to understand, but let's walk through each to ensure clarity. ## Step 1: Create a request token The first step as a developer is to request a new token. This is a **temporary token** required to ask the user for permission to access their account. This token will automatically expire **after 60 minutes** if it's not used. ## Step 2: Ask the user for permission With a request token in hand, forward your user to the following URL: ``` https://www.themoviedb.org/authenticate/{REQUEST_TOKEN} ``` You can also pass this URL a `redirect_to` parameter, like so: ``` https://www.themoviedb.org/authenticate/{REQUEST_TOKEN}?redirect_to=http://www.yourapp.com/approved ``` Once the user has approved your request token, they will either be redirected to the URL you specified in the `redirect_to` parameter or to the `/authenticate/allow` path on TMDB. If they aren't redirected to a custom URL, the page will also include an `Authentication-Callback` header. This header contains the API call for step #3. You can either manually generate it or simply use the one we return. ## Step 3: Create a session ID By calling the **new session method** with the request token that has been approved by the user in Step 2, we will return a **new session_id**. This session can now be used to write user data. You should treat this key **like a password** and keep it secret. ## What about guest sessions? A **guest session** can be used to rate movies **without** requiring a registered TMDB user account. For more information about how to create a guest session, see [here](https://developer.themoviedb.org/docs/authentication). - name: Certification - name: Changes - name: Collections - name: Companies - name: Configuration - name: Credits - name: Discover - name: Find - name: Genres - name: Guest Session - name: Keywords - name: List description: >- ## v3 or v4 list? 😕 You may have noticed that the a v4 version of our list API exists. While these v3 list methods continue to work, all of the new features you can see on our website are only available if you switch to the v4 lists. **What are some of the improvements in v4?** - 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 for more information. - name: Movie Lists - name: Movies - name: Networks - name: People Lists - name: People - name: Reviews - name: Search - name: Trending - name: TV Series Lists - name: TV Series - name: TV Seasons - name: TV Episodes - name: TV Episode Groups - name: Watch Providers paths: /3/tv/{{series_id}}/lists: parameters: - name: series_id in: path required: true schema: type: string get: tags: - TV Series summary: Lists description: Get the lists that a TV series has been added to. operationId: lists2 parameters: - name: language in: query schema: type: string example: en-US - name: page in: query schema: type: string example: '1' responses: '200': description: Lists headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=27386 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Fri, 10 Jan 2025 21:24:10 GMT ETag: schema: type: string example: W/"c89bfd508779808b2cb5a7dafd3f54f2" 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 39721a78218c7c28e95e60fe0370079c.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: 7VqQLaUArAILRDRMuGU6RJPFl9V2Bq-0KAOkb3OhgKUj0IGe07YTUQ== X-Amz-Cf-Pop: schema: type: string example: LOS50-P2 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: '27386' x-memc-key: schema: type: string example: 4b09712a6d13117f64d3be97490ecc1d content: application/json: schema: type: object properties: id: type: number example: 42705 page: type: number example: 1 results: type: array items: type: object properties: description: type: string example: Just an awesome list. favorite_count: type: number example: 0 id: type: number example: 8505719 iso_3166_1: type: string example: US iso_639_1: type: string example: en item_count: type: number example: 2 name: type: string example: The most amazing List. poster_path: nullable: true example: null example: - description: Just an awesome list. favorite_count: 0 id: 8505719 iso_3166_1: US iso_639_1: en item_count: 2 name: The most amazing List. poster_path: null - description: Just those creepy unsettling or random movies etc favorite_count: 0 id: 8505853 iso_3166_1: US iso_639_1: en item_count: 11 name: my world poster_path: null - description: '' favorite_count: 0 id: 8503128 iso_3166_1: US iso_639_1: en item_count: 261 name: ANIME poster_path: null - description: '' favorite_count: 0 id: 8501555 iso_3166_1: US iso_639_1: en item_count: 3 name: serie poster_path: null - description: GwaGwa Church Official TV Show Backlog. favorite_count: 0 id: 8254718 iso_3166_1: US iso_639_1: en item_count: 113 name: TV Backlog poster_path: null - description: '' favorite_count: 0 id: 6927344 iso_3166_1: US iso_639_1: en item_count: 693 name: Top Rated Series (minimum 100 votes) - IMDb poster_path: null - description: '' favorite_count: 0 id: 8497231 iso_3166_1: US iso_639_1: en item_count: 52 name: TVF_05 poster_path: null - description: '' favorite_count: 0 id: 8497172 iso_3166_1: US iso_639_1: en item_count: 2 name: Fighting Spirit poster_path: null - description: >- Movies and shows that I would like to recommend to everyone. Some are my favs and some are too good that I cannot help but praise them. favorite_count: 0 id: 8246123 iso_3166_1: US iso_639_1: en item_count: 125 name: Movies and Shows that I recommend poster_path: null - description: '' favorite_count: 0 id: 8428313 iso_3166_1: US iso_639_1: en item_count: 84 name: My anime list poster_path: null - description: '' favorite_count: 0 id: 8309148 iso_3166_1: US iso_639_1: en item_count: 39 name: Watched TV Shows poster_path: null - description: '' favorite_count: 0 id: 8309676 iso_3166_1: US iso_639_1: en item_count: 80 name: get er done poster_path: null - description: '' favorite_count: 0 id: 8307601 iso_3166_1: US iso_639_1: en item_count: 82 name: Animes que he visto poster_path: null - description: '' favorite_count: 0 id: 8270059 iso_3166_1: US iso_639_1: en item_count: 10 name: P10 poster_path: null - description: "Reyujays Tagalog List\r\nMovies and TV Series Tagalog Collection" favorite_count: 0 id: 8302682 iso_3166_1: US iso_639_1: en item_count: 790 name: Reyujays Tagalog List poster_path: null - description: '' favorite_count: 0 id: 6927356 iso_3166_1: US iso_639_1: en item_count: 900 name: Top Rated Series (minimum 1000 votes) - IMDb poster_path: null - description: '' favorite_count: 0 id: 146567 iso_3166_1: US iso_639_1: en item_count: 186 name: Anime Series poster_path: null - description: '' favorite_count: 0 id: 8279523 iso_3166_1: US iso_639_1: en item_count: 102 name: Anime Series poster_path: null - description: >- Where you could watch whatever you want to watching likewise mobile services to help you stay connected with your business partners with. favorite_count: 0 id: 8272772 iso_3166_1: US iso_639_1: en item_count: 41 name: All Movies Starts poster_path: null - description: '' favorite_count: 0 id: 7104246 iso_3166_1: US iso_639_1: en item_count: 63 name: Anime poster_path: null total_pages: type: number example: 2 total_results: type: number example: 34 examples: Lists: value: id: 42705 page: 1 results: - description: Just an awesome list. favorite_count: 0 id: 8505719 iso_3166_1: US iso_639_1: en item_count: 2 name: The most amazing List. poster_path: null - description: Just those creepy unsettling or random movies etc favorite_count: 0 id: 8505853 iso_3166_1: US iso_639_1: en item_count: 11 name: my world poster_path: null - description: '' favorite_count: 0 id: 8503128 iso_3166_1: US iso_639_1: en item_count: 261 name: ANIME poster_path: null - description: '' favorite_count: 0 id: 8501555 iso_3166_1: US iso_639_1: en item_count: 3 name: serie poster_path: null - description: GwaGwa Church Official TV Show Backlog. favorite_count: 0 id: 8254718 iso_3166_1: US iso_639_1: en item_count: 113 name: TV Backlog poster_path: null - description: '' favorite_count: 0 id: 6927344 iso_3166_1: US iso_639_1: en item_count: 693 name: Top Rated Series (minimum 100 votes) - IMDb poster_path: null - description: '' favorite_count: 0 id: 8497231 iso_3166_1: US iso_639_1: en item_count: 52 name: TVF_05 poster_path: null - description: '' favorite_count: 0 id: 8497172 iso_3166_1: US iso_639_1: en item_count: 2 name: Fighting Spirit poster_path: null - description: >- Movies and shows that I would like to recommend to everyone. Some are my favs and some are too good that I cannot help but praise them. favorite_count: 0 id: 8246123 iso_3166_1: US iso_639_1: en item_count: 125 name: Movies and Shows that I recommend poster_path: null - description: '' favorite_count: 0 id: 8428313 iso_3166_1: US iso_639_1: en item_count: 84 name: My anime list poster_path: null - description: '' favorite_count: 0 id: 8309148 iso_3166_1: US iso_639_1: en item_count: 39 name: Watched TV Shows poster_path: null - description: '' favorite_count: 0 id: 8309676 iso_3166_1: US iso_639_1: en item_count: 80 name: get er done poster_path: null - description: '' favorite_count: 0 id: 8307601 iso_3166_1: US iso_639_1: en item_count: 82 name: Animes que he visto poster_path: null - description: '' favorite_count: 0 id: 8270059 iso_3166_1: US iso_639_1: en item_count: 10 name: P10 poster_path: null - description: "Reyujays Tagalog List\r\nMovies and TV Series Tagalog Collection" favorite_count: 0 id: 8302682 iso_3166_1: US iso_639_1: en item_count: 790 name: Reyujays Tagalog List poster_path: null - description: '' favorite_count: 0 id: 6927356 iso_3166_1: US iso_639_1: en item_count: 900 name: Top Rated Series (minimum 1000 votes) - IMDb poster_path: null - description: '' favorite_count: 0 id: 146567 iso_3166_1: US iso_639_1: en item_count: 186 name: Anime Series poster_path: null - description: '' favorite_count: 0 id: 8279523 iso_3166_1: US iso_639_1: en item_count: 102 name: Anime Series poster_path: null - description: >- Where you could watch whatever you want to watching likewise mobile services to help you stay connected with your business partners with. favorite_count: 0 id: 8272772 iso_3166_1: US iso_639_1: en item_count: 41 name: All Movies Starts poster_path: null - description: '' favorite_count: 0 id: 7104246 iso_3166_1: US iso_639_1: en item_count: 63 name: Anime poster_path: null total_pages: 2 total_results: 34 ````