> ## 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 shows > This endpoint is used to get the TV shows rated by a TMDB account ## OpenAPI ````yaml api-reference/openapi.yaml get /3/account/{account_id}/rated/tv 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: get: tags: - Accounts - Ratings - TV shows12 summary: Get rated tv shows description: This endpoint is used to get the TV shows rated by a TMDB account operationId: getRatedTvShows parameters: - $ref: '#/components/parameters/accountID' - $ref: '#/components/parameters/sessionID' - $ref: '#/components/parameters/language' - $ref: '#/components/parameters/page' - $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 23:25:40 GMT ETag: schema: type: string example: W/"76d2bb1e3ccddb9cace3840f353e75bc" 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 919527ccf4988ee440e4f4dab0b5b5be.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: D9i48mTLgw9-quzW21WZ42L8tL_JfAvHHoXZ_EaJ4YqtJXamyeXAKg== 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: 3be6b80c2417c3314f6790e82c57ef3d content: application/json: schema: type: object properties: page: type: number example: 1 results: type: array items: allOf: - $ref: '#/components/schemas/accountTVResponse' - type: object properties: rating: type: number example: 6 description: The item's rating value added by the user. example: - adult: false backdrop_path: /5hS2OIuZSKGkR8R5l3bY5zh04Ce.jpg first_air_date: '2006-10-05' genre_ids: - 16 - 10765 - 10759 - 18 id: 31724 name: 'Code Geass: Lelouch of the Rebellion' origin_country: - JP original_language: ja original_name: コードギアス 反逆のルルーシュ overview: >- Japan has been invaded and conquered by the Britannian Empire. Japan is now known as Area 11 and its citizens known as Elevens. The Britannian Empire takes away Japan's autonomous power and imposes its rule through the use of Knightmares. The Empire's rule has never faltered, but cracks have begun to show... popularity: 161.186 poster_path: /2cBDhzbP7KOLbWtTzxS4WIDLh70.jpg rating: 6 vote_average: 8.368 vote_count: 741 total_pages: $ref: '#/components/schemas/totalPages' total_results: $ref: '#/components/schemas/totalResults' examples: Example response: value: page: 1 results: - adult: false backdrop_path: /5hS2OIuZSKGkR8R5l3bY5zh04Ce.jpg first_air_date: '2006-10-05' genre_ids: - 16 - 10765 - 10759 - 18 id: 31724 name: 'Code Geass: Lelouch of the Rebellion' origin_country: - JP original_language: ja original_name: コードギアス 反逆のルルーシュ overview: >- Japan has been invaded and conquered by the Britannian Empire. Japan is now known as Area 11 and its citizens known as Elevens. The Britannian Empire takes away Japan's autonomous power and imposes its rule through the use of Knightmares. The Empire's rule has never faltered, but cracks have begun to show... popularity: 161.186 poster_path: /2cBDhzbP7KOLbWtTzxS4WIDLh70.jpg rating: 6 vote_average: 8.368 vote_count: 741 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]() 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. page: in: query name: page schema: type: integer example: 1 description: A specific page number to get results for. Defaults to 1 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: accountTVResponse: type: object properties: adult: type: boolean example: false description: Indicates if the TV show contains adult content (true or false) backdrop_path: type: string example: /5hS2OIuZSKGkR8R5l3bY5zh04Ce.jpg description: Path to the TV show's backdrop path first_air_date: type: string example: '2006-10-05' description: The release date of the TV show's first episode. genre_ids: type: array items: type: number example: 16 description: List of genre IDs associated with the TV show example: - 16 - 10765 - 10759 - 18 id: type: number example: 31724 description: A unique identifier for the TV show name: type: string example: 'Code Geass: Lelouch of the Rebellion' description: The TV show's name origin_country: type: array items: type: string example: JP description: The list of countries where the TV show was originally produced. example: - JP original_language: type: string example: ja description: The TV show's original language code (e.g, "ja" for Japanese) original_name: type: string example: コードギアス 反逆のルルーシュ description: The original name/title of the TV show overview: type: string example: >- Japan has been invaded and conquered by the Britannian Empire. Japan is now known as Area 11 and its citizens known as Elevens. The Britannian Empire takes away Japan's autonomous power and imposes its rule through the use of Knightmares. The Empire's rule has never faltered, but cracks have begun to show... description: Brief summary or description of the TV show. popularity: type: number example: 161.186 description: >- A numeric value that represents the TV show's [popularity](https://emiloju.mintlify.app/popularity#popularity). poster_path: type: string example: /2cBDhzbP7KOLbWtTzxS4WIDLh70.jpg description: >- The path to the TV show's [poster image](https://emiloju.mintlify.app/image_basics). vote_average: type: number example: 8.372 description: Average user rating for the TV show on a scale of 1-10 vote_count: type: number example: 740 description: The total number of user votes for the TV show. 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 ````