> ## 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. # Favorite TV > This endpoint retrieves a list of your favorite TV shows. ## OpenAPI ````yaml api-reference/openapi.yaml get /3/account/{{account_id}}/favorite/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}}/favorite/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: Favorite TV description: This endpoint retrieves a list of your favorite TV shows. operationId: favoriteTv parameters: - name: language in: query schema: type: string example: en description: This represents the TV show language. - name: page in: query schema: type: string example: '1' description: This represents the page number. - name: sort_by in: query schema: type: string example: created_at.asc description: This represents how the retrieved list will be arranged. responses: '200': description: Favorite 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 12:40:38 GMT ETag: schema: type: string example: W/"362ac7f0ec19e52c1218e6b605f24d8e" 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 600860a2fda807ac628822c14b5de860.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: A4ORAfzU3rbvSfwNAOoS_V_f5wXOghfKMtT8_xdu3YDD2-I1vdzrlw== 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: 604ea67cfa58b9cb77be917ef6559fd6 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: /zZqpAXxVSBtxV9qPBcscfXBcL2w.jpg first_air_date: type: string example: '2011-04-17' genre_ids: type: array items: type: number example: 10765 example: - 10765 - 18 - 10759 id: type: number example: 1399 name: type: string example: Game of Thrones origin_country: type: array items: type: string example: US example: - US original_language: type: string example: en original_name: type: string example: Game of Thrones overview: type: string example: >- Seven noble families fight for control of the mythical land of Westeros. Friction between the houses leads to full-scale war. All while a very ancient evil awakens in the farthest north. Amidst the war, a neglected military order of misfits, the Night's Watch, is all that stands between the realms of men and icy horrors beyond. popularity: type: number example: 1348.329 poster_path: type: string example: /1XS1oqL89opfnbLl8WnZY1O1uJx.jpg vote_average: type: number example: 8.456 vote_count: type: number example: 24196 example: - adult: false backdrop_path: /zZqpAXxVSBtxV9qPBcscfXBcL2w.jpg first_air_date: '2011-04-17' genre_ids: - 10765 - 18 - 10759 id: 1399 name: Game of Thrones origin_country: - US original_language: en original_name: Game of Thrones overview: >- Seven noble families fight for control of the mythical land of Westeros. Friction between the houses leads to full-scale war. All while a very ancient evil awakens in the farthest north. Amidst the war, a neglected military order of misfits, the Night's Watch, is all that stands between the realms of men and icy horrors beyond. popularity: 1348.329 poster_path: /1XS1oqL89opfnbLl8WnZY1O1uJx.jpg vote_average: 8.456 vote_count: 24196 - adult: false backdrop_path: /cwKuMNndfjSl8iQIcAISL0C1tDZ.jpg first_air_date: '2011-06-23' genre_ids: - 18 id: 37680 name: Suits origin_country: - US original_language: en original_name: Suits overview: >- While running from a drug deal gone bad, Mike Ross, a brilliant young college-dropout, slips into a job interview with one of New York City's best legal closers, Harvey Specter. Tired of cookie-cutter law school grads, Harvey takes a gamble by hiring Mike on the spot after he recognizes his raw talent and photographic memory. popularity: 950.894 poster_path: /vQiryp6LioFxQThywxbC6TuoDjy.jpg vote_average: 8.23 vote_count: 5067 total_pages: type: number example: 1 total_results: type: number example: 2 examples: Favorite TV: value: page: 1 results: - adult: false backdrop_path: /zZqpAXxVSBtxV9qPBcscfXBcL2w.jpg first_air_date: '2011-04-17' genre_ids: - 10765 - 18 - 10759 id: 1399 name: Game of Thrones origin_country: - US original_language: en original_name: Game of Thrones overview: >- Seven noble families fight for control of the mythical land of Westeros. Friction between the houses leads to full-scale war. All while a very ancient evil awakens in the farthest north. Amidst the war, a neglected military order of misfits, the Night's Watch, is all that stands between the realms of men and icy horrors beyond. popularity: 1348.329 poster_path: /1XS1oqL89opfnbLl8WnZY1O1uJx.jpg vote_average: 8.456 vote_count: 24196 - adult: false backdrop_path: /cwKuMNndfjSl8iQIcAISL0C1tDZ.jpg first_air_date: '2011-06-23' genre_ids: - 18 id: 37680 name: Suits origin_country: - US original_language: en original_name: Suits overview: >- While running from a drug deal gone bad, Mike Ross, a brilliant young college-dropout, slips into a job interview with one of New York City's best legal closers, Harvey Specter. Tired of cookie-cutter law school grads, Harvey takes a gamble by hiring Mike on the spot after he recognizes his raw talent and photographic memory. popularity: 950.894 poster_path: /vQiryp6LioFxQThywxbC6TuoDjy.jpg vote_average: 8.23 vote_count: 5067 total_pages: 1 total_results: 2 components: securitySchemes: bearerAuth: type: http scheme: bearer ````