> ## 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 Movies > This endpoint retrieves a list of movies you have rated. ## OpenAPI ````yaml api-reference/openapi.yaml get /3/account/{{account_id}}/rated/movies 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/movies: 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 Movies description: |- This endpoint retrieves a list of movies you have rated. operationId: ratedMovies parameters: - name: language in: query schema: type: string 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. - 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 Movies 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:23:00 GMT ETag: schema: type: string example: W/"e8ecf99eea30470201255b72cb8c973e" 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 2f66aa06710fece8ed203ab0ea81eb56.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: RFQKcvNUeHb6lDUfUK1iKz1l6g8sQN1gxqLL4z8zPj3w6tLPmwXWGw== 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: 436375a364e504b68b4d072e8253cb5f 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: /au3o84ub27qTZiMiEc9UYzN74V3.jpg genre_ids: type: array items: type: number example: 28 example: - 28 - 878 - 53 id: type: number example: 1035048 original_language: type: string example: en original_title: type: string example: Elevation overview: type: string example: >- A single father and two women venture from the safety of their homes to face monstrous creatures to save the life of a young boy. popularity: type: number example: 2204.744 poster_path: type: string example: /uQhYBxOVFU6s9agD49FnGHwJqG5.jpg rating: type: number example: 6 release_date: type: string example: '2024-11-07' title: type: string example: Elevation video: type: boolean example: false vote_average: type: number example: 6.408 vote_count: type: number example: 87 example: - adult: false backdrop_path: /au3o84ub27qTZiMiEc9UYzN74V3.jpg genre_ids: - 28 - 878 - 53 id: 1035048 original_language: en original_title: Elevation overview: >- A single father and two women venture from the safety of their homes to face monstrous creatures to save the life of a young boy. popularity: 2204.744 poster_path: /uQhYBxOVFU6s9agD49FnGHwJqG5.jpg rating: 6 release_date: '2024-11-07' title: Elevation video: false vote_average: 6.408 vote_count: 87 - adult: false backdrop_path: /ihPcIUUzJpLYGGNgjQ1g7ExjHLT.jpg genre_ids: [] id: 1389586 original_language: en original_title: Peace Of My Heart overview: >- PEACE OF MY HEART(NEW MOVIE): BRYAN OKWARA, JULIET NJEMANZE 2024 FULL NIGERIAN MOVIE popularity: 0.695 poster_path: /aDg2bT8zkr1JANcLbYYVgfVtj41.jpg rating: 6 release_date: '2024-11-01' title: Peace Of My Heart video: false vote_average: 6 vote_count: 1 total_pages: type: number example: 1 total_results: type: number example: 2 examples: Rated Movies: value: page: 1 results: - adult: false backdrop_path: /au3o84ub27qTZiMiEc9UYzN74V3.jpg genre_ids: - 28 - 878 - 53 id: 1035048 original_language: en original_title: Elevation overview: >- A single father and two women venture from the safety of their homes to face monstrous creatures to save the life of a young boy. popularity: 2204.744 poster_path: /uQhYBxOVFU6s9agD49FnGHwJqG5.jpg rating: 6 release_date: '2024-11-07' title: Elevation video: false vote_average: 6.408 vote_count: 87 - adult: false backdrop_path: /ihPcIUUzJpLYGGNgjQ1g7ExjHLT.jpg genre_ids: [] id: 1389586 original_language: en original_title: Peace Of My Heart overview: >- PEACE OF MY HEART(NEW MOVIE): BRYAN OKWARA, JULIET NJEMANZE 2024 FULL NIGERIAN MOVIE popularity: 0.695 poster_path: /aDg2bT8zkr1JANcLbYYVgfVtj41.jpg rating: 6 release_date: '2024-11-01' title: Peace Of My Heart video: false vote_average: 6 vote_count: 1 total_pages: 1 total_results: 2 components: securitySchemes: bearerAuth: type: http scheme: bearer ````