> ## 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. # Rated TV Episodes > This endpoint retrieves the list of TV episodes you have rated. ## OpenAPI ````yaml api-reference/openapi.yaml get /3/account/{{account_id}}/rated/tv/episodes 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}}/rated/tv/episodes: 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: Rated TV Episodes description: |- This endpoint retrieves the list of TV episodes you have rated. operationId: ratedTvEpisodes 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: session_id in: query schema: type: string description: >- This represents your session Id. Get it [here](https://starlight.mintlify.app/api-reference/sessionid) - 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: Rated TV Episodes 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 13:57:45 GMT ETag: schema: type: string example: W/"6765558b5f4c365c02ca068c36df014e" 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 c889e9448c63bb4bf9dd41fcb2250e08.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: LXyXlJIMqp5Fz2nK2K_eexLNBlPg-YypSIyHjyqO29a1RbEJ_1mAmA== 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: ae78205f2b97f6d2c4d1cff3fdb3d3e6 content: application/json: schema: type: object properties: page: type: number example: 1 results: type: array items: type: object properties: air_date: type: string example: '2019-04-14' episode_number: type: number example: 1 episode_type: type: string example: standard id: type: number example: 1551825 name: type: string example: Winterfell overview: type: string example: >- Arriving at Winterfell, Jon and Daenerys struggle to unite a divided North. Jon Snow gets some big news. production_code: type: string example: '801' rating: type: number example: 7 runtime: type: number example: 55 season_number: type: number example: 8 show_id: type: number example: 1399 still_path: type: string example: /o65qwX1aHJclJ36VDhD3VYzz5em.jpg vote_average: type: number example: 7.171 vote_count: type: number example: 248 example: - air_date: '2019-04-14' episode_number: 1 episode_type: standard id: 1551825 name: Winterfell overview: >- Arriving at Winterfell, Jon and Daenerys struggle to unite a divided North. Jon Snow gets some big news. production_code: '801' rating: 7 runtime: 55 season_number: 8 show_id: 1399 still_path: /o65qwX1aHJclJ36VDhD3VYzz5em.jpg vote_average: 7.171 vote_count: 248 - air_date: '2019-04-28' episode_number: 3 episode_type: standard id: 1551827 name: The Long Night overview: >- The Night King and his army have arrived at Winterfell and the great battle begins. Arya looks to prove her worth as a fighter. production_code: '803' rating: 8 runtime: 82 season_number: 8 show_id: 1399 still_path: /mFtHbZenI5rRPqC5OFafoVmjEjq.jpg vote_average: 6.903 vote_count: 288 total_pages: type: number example: 1 total_results: type: number example: 2 examples: Rated TV Episodes: value: page: 1 results: - air_date: '2019-04-14' episode_number: 1 episode_type: standard id: 1551825 name: Winterfell overview: >- Arriving at Winterfell, Jon and Daenerys struggle to unite a divided North. Jon Snow gets some big news. production_code: '801' rating: 7 runtime: 55 season_number: 8 show_id: 1399 still_path: /o65qwX1aHJclJ36VDhD3VYzz5em.jpg vote_average: 7.171 vote_count: 248 - air_date: '2019-04-28' episode_number: 3 episode_type: standard id: 1551827 name: The Long Night overview: >- The Night King and his army have arrived at Winterfell and the great battle begins. Arya looks to prove her worth as a fighter. production_code: '803' rating: 8 runtime: 82 season_number: 8 show_id: 1399 still_path: /mFtHbZenI5rRPqC5OFafoVmjEjq.jpg vote_average: 6.903 vote_count: 288 total_pages: 1 total_results: 2 components: securitySchemes: bearerAuth: type: http scheme: bearer ````