> ## Documentation Index > Fetch the complete documentation index at: https://iqma-31aad55c.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Watchlist Movies > This endpoint is used to get a list of movies added to a users watchlist ## OpenAPI ````yaml api-reference/TMDB.json get /3/account/{account_id}/watchlist/movies openapi: 3.0.3 info: title: The Movie Database description: "# About\n\nThe Movie Database (TMDB) is a _community built_ movie and TV database. Every piece of data has been added by our amazing community dating back to 2008. TMDB's strong _international focus_ and breadth of data is largely unmatched and something we're incredibly proud of\n\nAlong with extensive metadata for movies, TV shows and people, we also offer one of the best selections of high resolution posters and backdrops. On average, over 1,000 images are added every single day.\n\n# Getting Started\n\nWelcome to version 3 (v3) of Ihe Movie Database(TMDB)API. This documentation serves as a guide to kick- start your experience with the world's largest movie database,\_Operating under the REST architecture. this API has become familiar to developers over the years, owing to its resemblance to the well-known web request and response pattern and its utillization of JSON as the preferred syntax for delivering responses.\n\nHere, you'll find information on all your favorite movies, including ratings, release dates, and much more. However, before you begin, be sure to explore the introductory pages, which include the Authentication page and the Errors & status code page.\_\n\n# Authentication \n\nBefore you can use the TMBD API, you need to generate your API Key - which is how you authenticate with the API.\nTo get an API key, you need to sign up at the officlal TMDB homepage. To do sign up, follow the steps below\_\n\n1. Navigate to the TMBD sign up page.\n\n2. After submitting your requested details, verify your account to login.\n3. Once you are logged in, you can now access your profile page containing information such as your most watched genres, and other recent activities.\n4. At the right corner of your profile page, navigate to your profile avatar and select the Settings options.\n5. On the settings page, navigate to the API option at the left corner menu.\n6. From the following options, chose the plan that suits you, The options include Developer and Professional. Both plans have their advantages listed below them.\n7.\_Once you select a plan, you'll fill out the form which would collect information about the API usage. information requested would include name of applicaton, it's url, etc.\n8. Once completed, you would be redirected to a new page where you'll see your generated API Key, Or check the notification icon for an instant message delivering your API key with additional informatian on the next steps to take." version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - apikey: [] tags: - name: Getting Started - name: Account description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Authentication description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Certifications - name: Changes - name: Collections description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Companies - name: Configuration - name: Credits description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Discover - name: Find description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Genres - name: Keywords description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Lists description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Movie Lists description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Movies description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Networks description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: People Lists - name: People description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Reviews description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Search - name: Trending - name: TV Series Lists - name: TV Series description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: TV Seasons - name: TV Episodes - name: TV Episode Groups description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Watch Provider paths: /3/account/{account_id}/watchlist/movies: parameters: - name: account_id in: path required: true schema: type: string get: tags: - Account summary: Watchlist Movies description: This endpoint is used to get a list of movies added to a users watchlist operationId: watchlistMovies parameters: - name: account_id in: query required: true schema: type: string example: 'null' description: int - name: language in: query schema: type: string example: en-US description: string - name: sort_by in: query schema: type: string example: created_at.asc description: string - name: session_id in: query required: true schema: type: string description: string responses: '200': description: OK 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: Sat, 14 Dec 2024 05:02:25 GMT ETag: schema: type: string example: W/"cd85b658171810043c3ffa9a6f4fbeaf" 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 f37f104903bda438e8b0547be6e0c192.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: JGhoGSLLFONNDd1xwRTjPJtrgafBSFHjtAERUWs-p76c0EmKxzMtxg== 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: e2c8c5e05d94cb4b51b0fe6a63acbbde 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: /zqkmTXzjkAgXmEWLRsY4UpTWCeo.jpg genre_ids: type: array items: type: number example: 12 example: - 12 - 28 - 878 id: type: number example: 11 original_language: type: string example: en original_title: type: string example: Star Wars overview: type: string example: >- Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire. popularity: type: number example: 80.681 poster_path: type: string example: /6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg release_date: type: string example: '1977-05-25' title: type: string example: Star Wars video: type: boolean example: false vote_average: type: number example: 8.204 vote_count: type: number example: 20638 example: - adult: false backdrop_path: /zqkmTXzjkAgXmEWLRsY4UpTWCeo.jpg genre_ids: - 12 - 28 - 878 id: 11 original_language: en original_title: Star Wars overview: >- Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire. popularity: 80.681 poster_path: /6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg release_date: '1977-05-25' title: Star Wars video: false vote_average: 8.204 vote_count: 20638 total_pages: type: number example: 1 total_results: type: number example: 1 examples: OK: value: page: 1 results: - adult: false backdrop_path: /zqkmTXzjkAgXmEWLRsY4UpTWCeo.jpg genre_ids: - 12 - 28 - 878 id: 11 original_language: en original_title: Star Wars overview: >- Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire. popularity: 80.681 poster_path: /6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg release_date: '1977-05-25' title: Star Wars video: false vote_average: 8.204 vote_count: 20638 total_pages: 1 total_results: 1 components: securitySchemes: apikey: type: apiKey name: '{{key}}' in: query ````