> ## Documentation Index > Fetch the complete documentation index at: https://emiloju.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get rated tv episodes > This endpoint is used to get the TV episodes rated by a TMDB account. ## OpenAPI ````yaml api-reference/openapi.yaml get /3/account/{account_id}/rated/tv/episodes openapi: 3.0.3 info: title: Endpoints description: This section contains all the endpoints used in the documentation. version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - bearerAuth: [] tags: - name: Authentication description: This section contains all endpoints used for authentication - name: Accounts description: This section contains account-specific endpoints. - name: Favorites description: >- This section contains all endpoints that allow a TMDB account to add movies, TV Shows, episodes to favorites, and also to get a list of favorites for the account. - name: Movies description: >- This section contains an endpoint to add a movie to favorites, and another to get a list of favorite movies for a TMDB account. - name: TV shows description: >- This section contains an endpoint to get the favorite TV shows for an account. - name: Watchlist description: >- This section contains all endpoints that allow a TMDB account to add movies, TV Shows to watchlist, and also to get a list of watchlist for the account. - name: Movies1 description: >- This section contains an endpoint that allows a TMDB account to add a movie to watchlist, and another to get the movies in a watchlist. - name: TV shows1 description: >- This section contains an endpoint used to get TV shows in an account's watchlist. - name: Ratings description: >- This section contains endpoints used to get all movies, TV Shows, and episodes rated by a TMDB account. - name: Movies12 description: >- This section contains an endpoint used to get a list of movies rated by a TMDB account. - name: TV shows12 description: >- This section contains an endpoint used to get a list of TV shows rated by a TMDB account. - name: Episodes description: >- This section contains an endpoint used to get a list of episodes rated by a TMDB account. - name: Lists description: Endpoints for a TMDB account lists. - name: Guest sessions description: This section contains all endpoints accessible by a guest session. - name: Movies description: For movies. - name: TV episodes description: >- This section contains all endpoints used to retrieve data for all TV episodes. - name: TV seasons description: >- This section contains all endpoints used to retrieve data for all TV seasons. - name: TV series description: >- This section contains all endpoints used to retrieve data for all TV series. - name: TV series lists description: This section contains all endpoints used to list TV series. - name: TV episode groups description: This section contains an endpoint used to retrieve data for TV episodes. - name: Watch providers description: Get available regions. - name: People description: About people lists. - name: Companies description: >- This section contains all endpoints used to retrieve data for supported companies. - name: Discover description: This section contains all endpoints used to discover movies and TV shows. - name: Recent changes description: >- This section contains all endpoints used to get recent changes in the TMDB database. - name: Credit description: This section contains an endpoint used to retrieve movie credits. - name: Certifications description: >- This section contains all endpoints used to get certification for movies and TV shows. - name: Collections description: This section contains all endpoints used to retrieve data for collections - name: Configuration description: >- This section contains all endpoints used to retrieve data on TMDB's configurations. - name: Find description: >- This section contains an endpoint used to search the TMDB database by External ID. - name: Genres description: This section contains endpoints related to genres. - name: Keywords description: >- This section contains an endpoint used to get keywords in the database by an ID. - name: Movie lists description: >- This section contains all endpoints used to retrieve movies by multiple search filters. - name: Networks description: For network endpoints. - name: Reviews description: For reviews endpoints. - name: Search description: For search endpoints. - name: Trending description: For trending videos. paths: /3/account/{account_id}/rated/tv/episodes: get: tags: - Accounts - Ratings - Episodes summary: Get rated tv episodes description: This endpoint is used to get the TV episodes rated by a TMDB account. operationId: getRatedTvEpisodes parameters: - $ref: '#/components/parameters/accountID' - $ref: '#/components/parameters/sessionID' - $ref: '#/components/parameters/page' - $ref: '#/components/parameters/language' - $ref: '#/components/parameters/sortBy' responses: '200': description: Request successful 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: Wed, 04 Dec 2024 22:59:28 GMT ETag: schema: type: string example: W/"5b333525ff117973180331432dc740b8" 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 f976d2c0a35af8b41b9970684d9b98cc.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: sH9u8piHhr5tp3RHOSqRX5xn7xr9icCLkVSzFkOIg1MUTtak9QA8rg== X-Amz-Cf-Pop: schema: type: string example: CDG50-C1 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: b489445565ce6a136435a8e38d3957ef content: application/json: schema: type: object properties: page: type: number example: 1 description: Current page number of the results results: type: array items: $ref: '#/components/schemas/accountTVEpisodes' example: - air_date: '2013-10-17' episode_number: 5 id: 64782 name: The Workplace Proximity overview: > Amy starts working at Caltech which causes friction with Sheldon. Howard agrees with Sheldon who mentions this to Bernadette causing a big fight for the Wolowitzes. production_code: 4X5305 runtime: 22 season_number: 7 show_id: 1418 still_path: /k8atjbd5gAsntuhbPnFpvnvo0qn.jpg vote_average: 7.242 vote_count: 31 rating: 8 description: A list of TV episodes rated by the user total_pages: $ref: '#/components/schemas/totalPages' total_results: $ref: '#/components/schemas/totalResults' examples: Example response: value: page: 1 results: - air_date: '2013-10-17' episode_number: 5 id: 64782 name: The Workplace Proximity overview: > Amy starts working at Caltech which causes friction with Sheldon. Howard agrees with Sheldon who mentions this to Bernadette causing a big fight for the Wolowitzes. production_code: 4X5305 runtime: 22 season_number: 7 show_id: 1418 still_path: /k8atjbd5gAsntuhbPnFpvnvo0qn.jpg vote_average: 7.242 vote_count: 31 rating: 8 total_pages: 1 total_results: 1 components: parameters: accountID: in: path name: account_id required: true schema: type: integer example: 548 description: >- A unique numeric identifier for a user account on TMDB. See how to get account id [here](). sessionID: in: query name: session_id schema: type: string example: 02a0e6d34dbd8325254e83c78918599076a62b0e description: >- A unique identifier for an authenticated user session. Usually used for [user authentication]() page: in: query name: page schema: type: integer example: 1 description: A specific page number to get results for. Defaults to 1 language: in: query name: language schema: type: string example: en-US description: > The language and region of the content, represented by an ISO 639-1 and ISO 3166-1 code combination (e.g, en-US for English, United States.). Defaults to en-US. sortBy: in: query name: sort_by schema: type: string enum: - created_at.asc - created_at.desc description: > Used to determine the order in which results are sorted in the response (ascending or descending). Allowed values: * `created_at.asc`: Sort by date created in ascending order * `created_at.desc`: sort by date created in descending order Defaults to `created_at.asc` schemas: accountTVEpisodes: type: object properties: air_date: type: string format: date description: The original date the episode was first aired in YYYY-MM-DD format. example: '2013-10-17' episode_number: type: integer description: The episode number within the season. example: 5 id: type: integer description: Unique identifier for the episode. example: 64782 name: type: string description: Title of the episode. example: The Workplace Proximity overview: type: string description: A brief summary of the episode's plot. example: >- Amy starts working at Caltech which causes friction with Sheldon. Howard agrees with Sheldon who mentions this to Bernadette causing a big fight for the Wolowitzes. production_code: type: string description: Internal production code assigned to the episode. example: 4X5305 runtime: type: integer description: Duration of the episode in minutes. example: 22 season_number: type: integer description: The season in which the episode appears. example: 7 show_id: type: integer description: Unique identifier for the TV show. example: 1418 still_path: type: string nullable: true description: Path to the episode's still image. Null if not available. example: /k8atjbd5gAsntuhbPnFpvnvo0qn.jpg vote_average: type: number format: float description: Average user rating for the episode. example: 7.242 vote_count: type: integer description: Total number of votes received for the episode. example: 31 rating: type: integer description: The user's personal rating for the episode. example: 8 totalPages: type: number example: 1 description: The total number of pages returned in the response totalResults: type: number example: 1 description: The total number of results returned in the response securitySchemes: bearerAuth: type: http scheme: bearer ````