> ## Documentation Index > Fetch the complete documentation index at: https://sirjosh.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Watchlist Movies > This endpoint get a list of movies added to a users watchlist. ## OpenAPI ````yaml api-reference/openapi3.json get /3/account/{account_id}/watchlist/movies openapi: 3.0.3 info: title: The Movie Database version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - bearerAuth: [] tags: - name: AUTHENTICATION - name: ACCOUNT - name: CERTIFICATIONS - name: CHANGES - name: COLLECTIONS - name: COMPANY - name: CONFIGURATION - name: CREDIT - name: DISCOVER - name: FIND - name: GENRES - name: GUEST SESSIONS - name: KEYWORDS - name: LISTS - name: MOVIE LISTS - name: MOVIES - name: NETWORKS - name: PEOPLE LIST - name: PEOPLE - name: REVIEWS - name: SEARCH - name: TRENDING - name: TV SERIES LIST - name: TV SERIES - name: TV SEASONS - name: TV EPISODES - name: TV EPISODE GROUP - name: WATCH PROVIDERS paths: /3/account/{account_id}/watchlist/movies: get: tags: - ACCOUNT summary: Watchlist Movies description: This endpoint get a list of movies added to a users watchlist. operationId: watchlistMovies parameters: - $ref: '#/components/parameters/language' - $ref: '#/components/parameters/page' - $ref: '#/components/parameters/session_id' - $ref: '#/components/parameters/sort_by' - $ref: '#/components/parameters/account_id' responses: '200': description: watchlist 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: Mon, 16 Dec 2024 15:40:09 GMT ETag: schema: type: string example: W/"236a88df5154c47b84382440419d9327" 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 156336391961f724345f6534c674b6ea.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: reLnD8t4AzJCx_uHiFVHPkGsUkkWcev9VHNB18i8KmgSNut-FL3pgw== 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: 01301caab4e56e6114537fccf5979538 content: application/json: schema: type: object properties: page: type: number example: 1 description: >- Indicates the current page number of the results being returned. results: type: array items: type: object properties: adult: type: boolean example: false description: >- Indicates if the movie is intended for adults (true) or is suitable for general audiences (false). backdrop_path: type: string example: /zqkmTXzjkAgXmEWLRsY4UpTWCeo.jpg description: >- The URL path to the movie's backdrop image (used for background displays). genre_ids: type: array items: type: number example: 12 example: - 12 - 28 - 878 description: >- An array of genre IDs that represent the types of genres the movie falls under. id: type: number example: 11 description: >- A unique identifier for the movie within the database. original_language: type: string example: en description: >- A string that specifies the original language in which the movie was produced, typically represented as a two-letter language code (e.g., "en" for English). original_title: type: string example: Star Wars description: >- The original title of the movie as it was released in its native language. 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. description: A brief summary of the movie's plot or storyline popularity: type: number example: 96.503 description: >- A numerical value indicating the popularity of the movie based on user ratings and engagement. A higher number suggests greater popularity in the viewing audience. poster_path: type: string example: /6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg description: >- The URL path to the movie's poster image (used for display purposes). release_date: type: string example: '1977-05-25' description: >- The date when the movie was released, represented in the format YYYY-MM-DD, indicating the specific day the movie became available to the public. title: type: string example: Star Wars description: The title of the movie as it appears in releases. video: type: boolean example: false description: >- A boolean value indicating whether there is an associated video (such as a trailer) available for the movie. true means there is a video, whereas false indicates there is none. vote_average: type: number example: 8.203 description: The average rating of the movie based on user votes. vote_count: type: number example: 20650 description: >- An integer representing the total number of votes that the movie has received. 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: 96.503 poster_path: /6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg release_date: '1977-05-25' title: Star Wars video: false vote_average: 8.203 vote_count: 20650 description: >- This represents a collection of movie objects returned by the API that provides information about various films. total_pages: type: number example: 1 description: The total number of pages available in the results. total_results: type: number example: 1 description: The total number of results found for the query submitted. examples: watchlist movies: 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: 96.503 poster_path: /6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg release_date: '1977-05-25' title: Star Wars video: false vote_average: 8.203 vote_count: 20650 total_pages: 1 total_results: 1 components: parameters: language: name: language in: query description: Specifies the language in which the response should be returned. schema: type: string example: en-US page: name: page in: query description: >- Indicates which page of results to return. Default is the first page (1). schema: type: integer example: 1 session_id: name: session_id in: query description: >- A token that represents a logged-in user's session after they have authenticated with their TMDB account. schema: type: string example: '' sort_by: name: sort_by in: query description: >- Determines how the results should be sorted. 'created_at.asc' indicates ascending order based on the creation date. schema: type: string enum: - created_at.asc - created_at.desc example: created_at.asc account_id: name: account_id in: path required: true description: This refers to a unique identifier assigned to a user account. schema: type: integer example: '' securitySchemes: bearerAuth: type: http scheme: bearer ````