> ## Documentation Index
> Fetch the complete documentation index at: https://devliz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List rated movies

> This endpoint allows you to get a user's list of rated movies.



## OpenAPI

````yaml get /account/{{account_id}}/rated/movies
openapi: 3.0.3
info:
  title: TMDB API DOCS
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org/3
  - url: https://api.themoviedb.org
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: >-
      This section contains endpoints that let you create authentication
      sessions for TMDB Guests and User accounts.
  - name: Account
    description: >-
      This section contains endpoints that let you access and sync with TMDB
      user account information.
  - name: Certifications
    description: >-
      This section contains endpoints that provide an up-to-date list of the
      officially supported movies and TV show certifications on TMDB.
  - name: Changes
    description: >-
      This section contains endpoints that let you fetch the list of Movie IDs,
      People IDs, and TV show IDs that have been changed in the past 24 hours.
  - name: Collections
    description: >-
      This collection contains endpoints that let you fetch movie collection
      details.
  - name: Discover
    description: >-
      This section contains endpoints that let you search for movies and TV
      shows, using sorts and filters.
  - name: Configuration
    description: This section contains endpoints that let you query the API configuration.
  - name: Movies
    description: >-
      This section contains endpoints that let you fetch information about the
      movie resource.
  - name: Companies
    description: >-
      This section contains endpoints that fetch information about a movie
      production company.
  - name: Credits
    description: This section contains endpoint for credit details.
  - name: Find
    description: This section contains endpoints that let you find movie or TV data.
  - name: Genres
    description: This section contain endpoints that let you get movie and TV genres.
  - name: Search
    description: This section contains endpoints that let you search through TMDB
  - name: Keywords
    description: This section contains endpoints for keyword information in TMDB
  - name: Movie Lists
    description: >-
      This section contains endpoints that let you fetch information about list
      of movies on TMDB
  - name: Networks
    description: >-
      This section contains endpoints that let you get information about the
      streaming networks.
  - name: People Lists
    description: This section contains endpoints of list of people.
  - name: People
    description: >-
      This section contains endpoints that let you get information about a
      person.
  - name: Reviews
    description: This section contains endpoints for movie or TV reviews.
  - name: Trending
    description: This section contains endpoints for trending movies, TV shows, and people.
  - name: TV Series List
    description: This section contains endpoints for listing TV series.
  - name: TV Series
    description: >-
      This section contains endpoints that let you get information for a TV
      series by ID
  - name: TV Seasons
    description: This section contains endpoints for TV show seasons.
  - name: TV Episodes
    description: >-
      This section contains endpoints that let you query information about a TV
      episode.
  - name: TV Episode groups
    description: This section contains endpoints for TV Episode information
  - name: Watch providers
    description: >-
      This section contains endpoints that let you get information about watch
      providers.
paths:
  /account/{{account_id}}/rated/movies:
    parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
    get:
      tags:
        - Account
      summary: List rated movies
      description: This endpoint allows you to get a user's list of rated movies.
      operationId: listRatedMovies
      parameters:
        - name: language
          in: query
          schema:
            type: string
            example: en-US
          description: language format of the details you want to get.
        - name: page
          in: query
          schema:
            type: string
            example: '1'
          description: what page the query belongs
        - name: sort_by
          in: query
          schema:
            type: string
            example: created_at.asc
          description: filter the query by ascending or descending order
        - name: session_id
          in: query
          schema:
            type: string
            example: string
          description: filter by the user session ID
      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: Tue, 10 Dec 2024 17:21:33 GMT
            ETag:
              schema:
                type: string
                example: W/"9cd08ffb7c721824ffe8910bf3affa6d"
            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 20579d8c7e6a7d159f211e9ee1d4003c.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: K1mSfSTj9fw5OW_rYgh5YepSDtg0hJjOvhLPLLgD454amqsj5fn-_A==
            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: a8b268a4c892e5fd4ba02414f3cfb84c
          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: /tElnmtQ6yz1PjN1kePNl8yMSb59.jpg
                        genre_ids:
                          type: array
                          items:
                            type: number
                            example: 16
                          example:
                            - 16
                            - 12
                            - 10751
                            - 35
                        id:
                          type: number
                          example: 1241982
                        original_language:
                          type: string
                          example: en
                        original_title:
                          type: string
                          example: Moana 2
                        overview:
                          type: string
                          example: >-
                            After receiving an unexpected call from her
                            wayfinding ancestors, Moana journeys alongside Maui
                            and a new crew to the far seas of Oceania and into
                            dangerous, long-lost waters for an adventure unlike
                            anything she's ever faced.
                        popularity:
                          type: number
                          example: 4485.032
                        poster_path:
                          type: string
                          example: /yh64qw9mgXBvlaWDi7Q9tpUBAvH.jpg
                        rating:
                          type: number
                          example: 8
                        release_date:
                          type: string
                          example: '2024-11-21'
                        title:
                          type: string
                          example: Moana 2
                        video:
                          type: boolean
                          example: false
                        vote_average:
                          type: number
                          example: 6.831
                        vote_count:
                          type: number
                          example: 425
                    example:
                      - adult: false
                        backdrop_path: /tElnmtQ6yz1PjN1kePNl8yMSb59.jpg
                        genre_ids:
                          - 16
                          - 12
                          - 10751
                          - 35
                        id: 1241982
                        original_language: en
                        original_title: Moana 2
                        overview: >-
                          After receiving an unexpected call from her wayfinding
                          ancestors, Moana journeys alongside Maui and a new
                          crew to the far seas of Oceania and into dangerous,
                          long-lost waters for an adventure unlike anything
                          she's ever faced.
                        popularity: 4485.032
                        poster_path: /yh64qw9mgXBvlaWDi7Q9tpUBAvH.jpg
                        rating: 8
                        release_date: '2024-11-21'
                        title: Moana 2
                        video: false
                        vote_average: 6.831
                        vote_count: 425
                  total_pages:
                    type: number
                    example: 1
                  total_results:
                    type: number
                    example: 1
              examples:
                Rated movies:
                  value:
                    page: 1
                    results:
                      - adult: false
                        backdrop_path: /tElnmtQ6yz1PjN1kePNl8yMSb59.jpg
                        genre_ids:
                          - 16
                          - 12
                          - 10751
                          - 35
                        id: 1241982
                        original_language: en
                        original_title: Moana 2
                        overview: >-
                          After receiving an unexpected call from her wayfinding
                          ancestors, Moana journeys alongside Maui and a new
                          crew to the far seas of Oceania and into dangerous,
                          long-lost waters for an adventure unlike anything
                          she's ever faced.
                        popularity: 4485.032
                        poster_path: /yh64qw9mgXBvlaWDi7Q9tpUBAvH.jpg
                        rating: 8
                        release_date: '2024-11-21'
                        title: Moana 2
                        video: false
                        vote_average: 6.831
                        vote_count: 425
                    total_pages: 1
                    total_results: 1
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````