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

# Account States

> This endpoint get the rating, watchlist and favourite status.



## OpenAPI

````yaml api-reference/openapi3.json get /3/tv/{series_id}/season/{season_number}/account_states
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/tv/{series_id}/season/{season_number}/account_states:
    get:
      tags:
        - TV SEASONS
      summary: Account States
      description: This endpoint get the rating, watchlist and favourite status.
      operationId: accountStates2
      parameters:
        - name: guest_session_id
          in: query
          description: >-
            It represents a unique identifier for a session that is created for
            a guest user.
          schema:
            type: string
        - $ref: '#/components/parameters/session_id'
        - $ref: '#/components/parameters/season_number'
        - $ref: '#/components/parameters/series_id'
      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: Sun, 05 Jan 2025 23:42:39 GMT
            ETag:
              schema:
                type: string
                example: W/"bea548bbe1b20ee79370c2c467ca44e4"
            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 08f45c153a856ff7955174d0e6f60744.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: YVYONUo6LRWUwPzi_VyqqZ2fb4lbxDm5dj4BXALdkmGBwEvyUCw5hw==
            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: 239f0f5ac19c423c51c7b506cd070e20
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: number
                    example: 3572
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        episode_number:
                          type: number
                          example: 1
                        id:
                          type: number
                          example: 62085
                        rated:
                          type: boolean
                          example: false
                    example:
                      - episode_number: 1
                        id: 62085
                        rated: false
                      - episode_number: 2
                        id: 62086
                        rated: false
                      - episode_number: 3
                        id: 62087
                        rated: false
                      - episode_number: 4
                        id: 62088
                        rated: false
                      - episode_number: 5
                        id: 62089
                        rated: false
                      - episode_number: 6
                        id: 62090
                        rated: false
                      - episode_number: 7
                        id: 62091
                        rated: false
              examples:
                account states:
                  value:
                    id: 3572
                    results:
                      - episode_number: 1
                        id: 62085
                        rated: false
                      - episode_number: 2
                        id: 62086
                        rated: false
                      - episode_number: 3
                        id: 62087
                        rated: false
                      - episode_number: 4
                        id: 62088
                        rated: false
                      - episode_number: 5
                        id: 62089
                        rated: false
                      - episode_number: 6
                        id: 62090
                        rated: false
                      - episode_number: 7
                        id: 62091
                        rated: false
components:
  parameters:
    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: ''
    season_number:
      name: season_number
      in: path
      required: true
      description: >-
        This refers to the numerical identifier assigned to a specific season of
        a TV series.
      schema:
        type: integer
        example: ''
    series_id:
      name: series_id
      in: path
      required: true
      description: >-
        This refers to a unique identifier assigned to a television series
        within the database.
      schema:
        type: integer
        example: ''
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````