> ## 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. # Favorite Movies > This endpoint retrieves a list of your favorite movies. ## OpenAPI ````yaml api-reference/openapi.yaml get /3/account/{{account_id}}/favorite/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}}/favorite/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: Favorite Movies description: This endpoint retrieves a list of your favorite movies. operationId: favoriteMovies 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: sort_by in: query schema: type: string example: created_at.asc description: This represents how the retrieved list will be arranged. responses: '200': description: Favorite 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 12:00:18 GMT ETag: schema: type: string example: W/"c436632dc8babbb427a3aa4316a3794b" 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 47c0295005ec7d8570406951491004c2.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: av0syVF7wr7DBeluJBehMzppXBGMqsq4WB9JIeBDI3lT61NIlTbLTQ== 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: 47d55fe4228200b7b7bb0ccdb88d98b8 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: /h3fwlwHotd3JfV13HdW0mxDcxPD.jpg genre_ids: type: array items: type: number example: 35 example: - 35 - 10749 - 10770 id: type: number example: 957119 original_language: type: string example: en original_title: type: string example: 'Sidelined: The QB and Me' overview: type: string example: >- Dallas, a burdened but headstrong dancer, is determined to get into the best dance school in the country—her late mother’s alma mater. However, that dream is suddenly derailed when the cheeky yet secretly grieving football star, Drayton, crashes into her life with a unique story of his own. Will the two of them be able to grow into their dreams together, or will their dreams be sidelined? popularity: type: number example: 1605.297 poster_path: type: string example: /sIWv5HtDlUFvacsuA1fRNWZ5GFH.jpg release_date: type: string example: '2024-11-29' title: type: string example: 'Sidelined: The QB and Me' video: type: boolean example: false vote_average: type: number example: 6.5 vote_count: type: number example: 40 example: - adult: false backdrop_path: /h3fwlwHotd3JfV13HdW0mxDcxPD.jpg genre_ids: - 35 - 10749 - 10770 id: 957119 original_language: en original_title: 'Sidelined: The QB and Me' overview: >- Dallas, a burdened but headstrong dancer, is determined to get into the best dance school in the country—her late mother’s alma mater. However, that dream is suddenly derailed when the cheeky yet secretly grieving football star, Drayton, crashes into her life with a unique story of his own. Will the two of them be able to grow into their dreams together, or will their dreams be sidelined? popularity: 1605.297 poster_path: /sIWv5HtDlUFvacsuA1fRNWZ5GFH.jpg release_date: '2024-11-29' title: 'Sidelined: The QB and Me' video: false vote_average: 6.5 vote_count: 40 - adult: false backdrop_path: /euYIwmwkmz95mnXvufEmbL6ovhZ.jpg genre_ids: - 28 - 12 - 36 id: 558449 original_language: en original_title: Gladiator II overview: >- Years after witnessing the death of the revered hero Maximus at the hands of his uncle, Lucius is forced to enter the Colosseum after his home is conquered by the tyrannical Emperors who now lead Rome with an iron fist. With rage in his heart and the future of the Empire at stake, Lucius must look to his past to find strength and honor to return the glory of Rome to its people. popularity: 1244.766 poster_path: /2cxhvwyEwRlysAmRH4iodkvo0z5.jpg release_date: '2024-11-13' title: Gladiator II video: false vote_average: 6.654 vote_count: 923 total_pages: type: number example: 1 total_results: type: number example: 2 examples: Favorite Movies: value: page: 1 results: - adult: false backdrop_path: /h3fwlwHotd3JfV13HdW0mxDcxPD.jpg genre_ids: - 35 - 10749 - 10770 id: 957119 original_language: en original_title: 'Sidelined: The QB and Me' overview: >- Dallas, a burdened but headstrong dancer, is determined to get into the best dance school in the country—her late mother’s alma mater. However, that dream is suddenly derailed when the cheeky yet secretly grieving football star, Drayton, crashes into her life with a unique story of his own. Will the two of them be able to grow into their dreams together, or will their dreams be sidelined? popularity: 1605.297 poster_path: /sIWv5HtDlUFvacsuA1fRNWZ5GFH.jpg release_date: '2024-11-29' title: 'Sidelined: The QB and Me' video: false vote_average: 6.5 vote_count: 40 - adult: false backdrop_path: /euYIwmwkmz95mnXvufEmbL6ovhZ.jpg genre_ids: - 28 - 12 - 36 id: 558449 original_language: en original_title: Gladiator II overview: >- Years after witnessing the death of the revered hero Maximus at the hands of his uncle, Lucius is forced to enter the Colosseum after his home is conquered by the tyrannical Emperors who now lead Rome with an iron fist. With rage in his heart and the future of the Empire at stake, Lucius must look to his past to find strength and honor to return the glory of Rome to its people. popularity: 1244.766 poster_path: /2cxhvwyEwRlysAmRH4iodkvo0z5.jpg release_date: '2024-11-13' title: Gladiator II video: false vote_average: 6.654 vote_count: 923 total_pages: 1 total_results: 2 components: securitySchemes: bearerAuth: type: http scheme: bearer ````