> ## Documentation Index
> Fetch the complete documentation index at: https://ileolami.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 get /3/account/{account_id}/watchlist/movies
openapi: 3.0.3
info:
  title: The Movie Database
  description: Reference
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
security:
  - bearerAuth: []
tags:
  - name: ACCOUNT
  - name: AUTHENTICATION
  - name: CERTIFICATION
  - name: CHANGES
  - name: COLLECTION
  - name: COMPANIES
  - name: CONFIGURATION
  - name: CREDITS
  - name: DISCOVER
  - name: FIND
  - name: GENRES
  - name: GUEST SESSION
  - name: KEYWORDS
  - name: LISTS
  - name: MOVIE LISTS
  - name: MOVIES
  - name: NETWORK
  - name: PEOPLE
  - name: PEOPLE LISTS
  - name: REVIEWS
  - name: SEARCH
  - name: TRENDING
  - name: TV SERIES LIST
  - name: TV SERIES
  - name: TV SEASONS
  - name: TV EPISODES
  - name: TV EPISODES GROUPS
  - name: WATCH PROVIDERS
paths:
  /3/account/{account_id}/watchlist/movies:
    parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: integer
        description: unique identifier of user's account
    get:
      tags:
        - ACCOUNT
      summary: Watchlist Movies
      description: This endpoint get a list of movies added to a users watchlist.
      operationId: watchlistMovies
      parameters:
        - name: page
          in: query
          schema:
            type: integer
            default: 1
          description: page number to retrieve specific paginated results.
        - name: session_id
          in: query
          schema:
            type: string
          description: session ID for authentication or tracking purposes
        - name: language
          in: query
          schema:
            type: string
            default: en-US
          description: language based on region
        - name: sort_by
          in: query
          description: Sort the results either in ascending order or descending order
          schema:
            type: string
            enum:
              - created_at.asc
              - created_at.desc
      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: Thu, 26 Dec 2024 13:35:02 GMT
            ETag:
              schema:
                type: string
                example: W/"b75c51065567a5b37152e555ff4653ad"
            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 c73c454a7c881cf4337ab88377497bfc.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: xhxeWzFbVSrrNsDQT0z_pLHDBY7jCJrPtg7MDb2hiQdiZA--BC_Fww==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: DFW57-P2
            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: 1564974cf2f832e11b98a13a3df84078
          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: /4qCqAdHcNKeAHcK8tJ8wNJZa9cx.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: 101.129
                        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.203
                        vote_count:
                          type: number
                          example: 20688
                    example:
                      - adult: false
                        backdrop_path: /4qCqAdHcNKeAHcK8tJ8wNJZa9cx.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: 101.129
                        poster_path: /6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg
                        release_date: '1977-05-25'
                        title: Star Wars
                        video: false
                        vote_average: 8.203
                        vote_count: 20688
                  total_pages:
                    type: number
                    example: 1
                  total_results:
                    type: number
                    example: 1
              examples:
                Watchlist Movies:
                  value:
                    page: 1
                    results:
                      - adult: false
                        backdrop_path: /4qCqAdHcNKeAHcK8tJ8wNJZa9cx.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: 101.129
                        poster_path: /6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg
                        release_date: '1977-05-25'
                        title: Star Wars
                        video: false
                        vote_average: 8.203
                        vote_count: 20688
                    total_pages: 1
                    total_results: 1
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````