> ## 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.

# Movie States

> This endpoint allows you to check if a movie has been added to favorite, rated, or watchlist in your account.



## OpenAPI

````yaml api-reference/openapi.yaml get /3/movie/{{movie_id}}/account_states
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/movie/{{movie_id}}/account_states:
    parameters:
      - name: movie_id
        in: path
        description: >-
          This represents the movie ID. Get it
          [here](https://starlight.mintlify.app/api-reference/movieid)
        required: true
        schema:
          type: string
    get:
      tags:
        - Movies
      summary: Movie States
      description: >-
        This endpoint allows you to check if a movie has been added to favorite,
        rated, or watchlist in your account.
      operationId: movieStates
      responses:
        '200':
          description: Account States
          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, 24 Dec 2024 15:42:21 GMT
            ETag:
              schema:
                type: string
                example: W/"70f0e5a5f1d1f3d67ac5dbf10f8d276c"
            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 8d6071bd169bbf5fd46638140132b1d0.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: zZWzTp3V_T1mj8AsD2nqA43Jnl2vYvIdksSQmbl7uGA0B6f9ABOE-g==
            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: 19e1931ef601be5421fccea14927a2d0
          content:
            application/json:
              schema:
                type: object
                properties:
                  favorite:
                    type: boolean
                    example: false
                  id:
                    type: number
                    example: 1035048
                  rated:
                    type: object
                    properties:
                      value:
                        type: number
                        example: 6
                  watchlist:
                    type: boolean
                    example: false
              examples:
                Account States:
                  value:
                    favorite: false
                    id: 1035048
                    rated:
                      value: 6
                    watchlist: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````