> ## 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. # TV Watchlist > This endpoint retrieves your TV watchlist. ## OpenAPI ````yaml api-reference/openapi.yaml get /3/account/{{account_id}}/watchlist/tv 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/account/{{account_id}}/watchlist/tv: parameters: - name: account_id in: path description: >- This represents your account ID. Get it [here](https://starlight.mintlify.app/api-reference/accountid) required: true schema: type: string get: tags: - Account summary: TV Watchlist description: This endpoint retrieves your TV watchlist. operationId: tvWatchlist 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. - name: session_id in: query schema: type: string description: >- This represents your session Id. Get it [here](https://starlight.mintlify.app/api-reference/seriesid) - name: sort_by in: query schema: type: string example: created_at.asc description: >+ This specifies the order in which the retrieved list will be displayed. responses: '200': description: Watchlist TV headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=0 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Thu, 05 Dec 2024 14:48:17 GMT ETag: schema: type: string example: W/"48c4b37f6609128388ed06617f26ee01" 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 08f45c153a856ff7955174d0e6f60744.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: s-mQX2H1yFEUKAFxV-rjQ6zJpQ-pOOkqkmjqRl3xQeDuF_2dj1ngLg== 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 x-memc-age: schema: type: string example: '0' x-memc-expires: schema: type: string example: '0' x-memc-key: schema: type: string example: 3306da0e5b760731ae952f06db4c048f content: application/json: schema: type: object properties: page: type: number example: 1 results: type: array items: type: object properties: adult: type: boolean example: false backdrop_path: type: string example: /2Erj4Oav9EHAtqLI354VM7ULDqu.jpg first_air_date: type: string example: '2018-06-20' genre_ids: type: array items: type: number example: 37 example: - 37 - 18 id: type: number example: 73586 name: type: string example: Yellowstone origin_country: type: array items: type: string example: US example: - US original_language: type: string example: en original_name: type: string example: Yellowstone overview: type: string example: >- Follow the violent world of the Dutton family, who controls the largest contiguous ranch in the United States. Led by their patriarch John Dutton, the family defends their property against constant attack by land developers, an Indian reservation, and America’s first National Park. popularity: type: number example: 1413.651 poster_path: type: string example: /s4QRRYc1V2e68Qy9Wel9MI8fhRP.jpg vote_average: type: number example: 8.222 vote_count: type: number example: 2410 example: - adult: false backdrop_path: /2Erj4Oav9EHAtqLI354VM7ULDqu.jpg first_air_date: '2018-06-20' genre_ids: - 37 - 18 id: 73586 name: Yellowstone origin_country: - US original_language: en original_name: Yellowstone overview: >- Follow the violent world of the Dutton family, who controls the largest contiguous ranch in the United States. Led by their patriarch John Dutton, the family defends their property against constant attack by land developers, an Indian reservation, and America’s first National Park. popularity: 1413.651 poster_path: /s4QRRYc1V2e68Qy9Wel9MI8fhRP.jpg vote_average: 8.222 vote_count: 2410 - adult: false backdrop_path: /7w165QdHmJuTHSQwEyJDBDpuDT7.jpg first_air_date: '2005-08-29' genre_ids: - 10759 - 80 - 18 id: 2288 name: Prison Break origin_country: - US original_language: en original_name: Prison Break overview: >- Due to a political conspiracy, an innocent man is sent to death row and his only hope is his brother, who makes it his mission to deliberately get himself sent to the same prison in order to break the both of them out, from the inside out. popularity: 805.203 poster_path: /5E1BhkCgjLBlqx557Z5yzcN0i88.jpg vote_average: 8.075 vote_count: 5143 total_pages: type: number example: 1 total_results: type: number example: 2 examples: Watchlist TV: value: page: 1 results: - adult: false backdrop_path: /2Erj4Oav9EHAtqLI354VM7ULDqu.jpg first_air_date: '2018-06-20' genre_ids: - 37 - 18 id: 73586 name: Yellowstone origin_country: - US original_language: en original_name: Yellowstone overview: >- Follow the violent world of the Dutton family, who controls the largest contiguous ranch in the United States. Led by their patriarch John Dutton, the family defends their property against constant attack by land developers, an Indian reservation, and America’s first National Park. popularity: 1413.651 poster_path: /s4QRRYc1V2e68Qy9Wel9MI8fhRP.jpg vote_average: 8.222 vote_count: 2410 - adult: false backdrop_path: /7w165QdHmJuTHSQwEyJDBDpuDT7.jpg first_air_date: '2005-08-29' genre_ids: - 10759 - 80 - 18 id: 2288 name: Prison Break origin_country: - US original_language: en original_name: Prison Break overview: >- Due to a political conspiracy, an innocent man is sent to death row and his only hope is his brother, who makes it his mission to deliberately get himself sent to the same prison in order to break the both of them out, from the inside out. popularity: 805.203 poster_path: /5E1BhkCgjLBlqx557Z5yzcN0i88.jpg vote_average: 8.075 vote_count: 5143 total_pages: 1 total_results: 2 components: securitySchemes: bearerAuth: type: http scheme: bearer ````