> ## 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 a TV show has been added to. ## OpenAPI ````yaml api-reference/openapi.yaml get /3/tv/{{series_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/tv/{{series_id}}/lists: parameters: - name: series_id in: path description: >- This represents the series ID. Get it [here](https://starlight.mintlify.app/api-reference/seriesid) required: true schema: type: string get: tags: - TV Series summary: Lists description: This endpoint retrieves the list that a TV show has been added to. operationId: lists2 parameters: - name: language in: query schema: type: string example: en description: This represents the 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=10285 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Sun, 29 Dec 2024 20:16:59 GMT ETag: schema: type: string example: W/"8306c79ac2f54f5fd7999ccd498eeb92" 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 9c90b41a9e5ac2856624d29ed4da4234.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: NMPdcuCHX8ts6WktonhTaqMnVxEiJr1cxjPNSE4kwYPl9LcdsAofMw== 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: '12672' x-memc-expires: schema: type: string example: '10285' x-memc-key: schema: type: string example: de13c829748a01fc61611dcdb193c328 content: application/json: schema: type: object properties: id: type: number example: 93405 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: 8502269 iso_3166_1: type: string example: US iso_639_1: type: string example: en item_count: type: number example: 5 name: type: string example: WÃF poster_path: nullable: true example: null example: - description: '' favorite_count: 0 id: 8502269 iso_3166_1: US iso_639_1: en item_count: 5 name: WÃF poster_path: null - description: '' favorite_count: 0 id: 8501855 iso_3166_1: US iso_639_1: en item_count: 43 name: like a ghost poster_path: null - description: '' favorite_count: 0 id: 8503165 iso_3166_1: US iso_639_1: en item_count: 9 name: movie poster_path: null - description: '' favorite_count: 0 id: 8285530 iso_3166_1: US iso_639_1: en item_count: 20 name: Series2024 poster_path: null - description: '' favorite_count: 0 id: 8501476 iso_3166_1: US iso_639_1: en item_count: 50 name: watchlist poster_path: null - description: >- netflix Top 10 TV Shows - Updated 2024-12-29T09:03:23.707-05:00 favorite_count: 0 id: 8302714 iso_3166_1: US iso_639_1: en item_count: 8 name: Top 10 TV Shows - Netflix poster_path: null - description: '' favorite_count: 0 id: 8503943 iso_3166_1: US iso_639_1: en item_count: 1 name: squid game poster_path: null - description: '' favorite_count: 0 id: 8311545 iso_3166_1: US iso_639_1: en item_count: 15 name: 'Currently Watching ' poster_path: null - description: '' favorite_count: 0 id: 8503152 iso_3166_1: US iso_639_1: en item_count: 13 name: DeyBey poster_path: null - description: '' favorite_count: 0 id: 8501592 iso_3166_1: US iso_639_1: en item_count: 15 name: a poster_path: null - description: '' favorite_count: 0 id: 8503669 iso_3166_1: US iso_639_1: en item_count: 20 name: . poster_path: null - description: '' favorite_count: 0 id: 8503898 iso_3166_1: US iso_639_1: en item_count: 1 name: 'Series ' poster_path: null - description: '' favorite_count: 0 id: 8503896 iso_3166_1: US iso_639_1: en item_count: 1 name: taha 1 poster_path: null - description: '' favorite_count: 0 id: 8502193 iso_3166_1: US iso_639_1: en item_count: 7 name: 'movie ' poster_path: null - description: '' favorite_count: 0 id: 8501754 iso_3166_1: US iso_639_1: en item_count: 26 name: shows poster_path: null - description: '' favorite_count: 0 id: 8503878 iso_3166_1: US iso_639_1: en item_count: 3 name: '2024' poster_path: null - description: Shows to watch… favorite_count: 0 id: 8502052 iso_3166_1: US iso_639_1: en item_count: 18 name: TV Shows poster_path: null - description: '' favorite_count: 0 id: 8173010 iso_3166_1: US iso_639_1: en item_count: 609 name: SERIES poster_path: null - description: '' favorite_count: 0 id: 8502823 iso_3166_1: US iso_639_1: en item_count: 2 name: watching/ watched poster_path: null - description: '' favorite_count: 0 id: 8503586 iso_3166_1: US iso_639_1: en item_count: 2 name: 'série à regarder ' poster_path: null total_pages: type: number example: 20 total_results: type: number example: 391 examples: Lists: value: id: 93405 page: 1 results: - description: '' favorite_count: 0 id: 8502269 iso_3166_1: US iso_639_1: en item_count: 5 name: WÃF poster_path: null - description: '' favorite_count: 0 id: 8501855 iso_3166_1: US iso_639_1: en item_count: 43 name: like a ghost poster_path: null - description: '' favorite_count: 0 id: 8503165 iso_3166_1: US iso_639_1: en item_count: 9 name: movie poster_path: null - description: '' favorite_count: 0 id: 8285530 iso_3166_1: US iso_639_1: en item_count: 20 name: Series2024 poster_path: null - description: '' favorite_count: 0 id: 8501476 iso_3166_1: US iso_639_1: en item_count: 50 name: watchlist poster_path: null - description: >- netflix Top 10 TV Shows - Updated 2024-12-29T09:03:23.707-05:00 favorite_count: 0 id: 8302714 iso_3166_1: US iso_639_1: en item_count: 8 name: Top 10 TV Shows - Netflix poster_path: null - description: '' favorite_count: 0 id: 8503943 iso_3166_1: US iso_639_1: en item_count: 1 name: squid game poster_path: null - description: '' favorite_count: 0 id: 8311545 iso_3166_1: US iso_639_1: en item_count: 15 name: 'Currently Watching ' poster_path: null - description: '' favorite_count: 0 id: 8503152 iso_3166_1: US iso_639_1: en item_count: 13 name: DeyBey poster_path: null - description: '' favorite_count: 0 id: 8501592 iso_3166_1: US iso_639_1: en item_count: 15 name: a poster_path: null - description: '' favorite_count: 0 id: 8503669 iso_3166_1: US iso_639_1: en item_count: 20 name: . poster_path: null - description: '' favorite_count: 0 id: 8503898 iso_3166_1: US iso_639_1: en item_count: 1 name: 'Series ' poster_path: null - description: '' favorite_count: 0 id: 8503896 iso_3166_1: US iso_639_1: en item_count: 1 name: taha 1 poster_path: null - description: '' favorite_count: 0 id: 8502193 iso_3166_1: US iso_639_1: en item_count: 7 name: 'movie ' poster_path: null - description: '' favorite_count: 0 id: 8501754 iso_3166_1: US iso_639_1: en item_count: 26 name: shows poster_path: null - description: '' favorite_count: 0 id: 8503878 iso_3166_1: US iso_639_1: en item_count: 3 name: '2024' poster_path: null - description: Shows to watch… favorite_count: 0 id: 8502052 iso_3166_1: US iso_639_1: en item_count: 18 name: TV Shows poster_path: null - description: '' favorite_count: 0 id: 8173010 iso_3166_1: US iso_639_1: en item_count: 609 name: SERIES poster_path: null - description: '' favorite_count: 0 id: 8502823 iso_3166_1: US iso_639_1: en item_count: 2 name: watching/ watched poster_path: null - description: '' favorite_count: 0 id: 8503586 iso_3166_1: US iso_639_1: en item_count: 2 name: 'série à regarder ' poster_path: null total_pages: 20 total_results: 391 components: securitySchemes: bearerAuth: type: http scheme: bearer ````