> ## 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 TV Shows

> This endpoint get a users TV watchlist.



## OpenAPI

````yaml get /4/account/{account_object_id}/tv/watchlist
openapi: 3.0.3
info:
  title: Version 4
  description: This API is the version 4 of TMDB API
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
security:
  - bearerAuth: []
tags:
  - name: ACCOUNT
  - name: AUTH
  - name: LISTS
    description: For this folder, you will need to create an access token
paths:
  /4/account/{account_object_id}/tv/watchlist:
    parameters:
      - name: account_object_id
        in: path
        required: true
        schema:
          type: string
    get:
      tags:
        - ACCOUNT
      summary: Watchlist TV Shows
      description: This endpoint get a users TV watchlist.
      operationId: watchlistTvShows
      parameters:
        - name: page
          description: the page number
          in: query
          schema:
            type: integer
            default: 1
        - name: language
          description: The ISO 639-1 code for the language
          in: query
          schema:
            type: string
            default: en-US
        - name: sort_by
          in: query
          schema:
            type: string
            enum:
              - created_at.asc
              - created_at.desc
      responses:
        '200':
          description: Watchlist TV Shows
          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, 03 Mar 2025 09:03:30 GMT
            ETag:
              schema:
                type: string
                example: W/"216c3bf86eb8270e041099ee8df52e06"
            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 a95a47d0ae281d5cb9d53eb5abd9a948.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: Hq8ofkHFyMn0PDIkBTgi9c8KPbqm7K52LkA-_M1XGkeJaYV1gksFQQ==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: LOS50-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: 9555155070257da4e78f16173ef4abe7
          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: /hFFAYkK8XkvIlQss9GYxo8TOhFi.jpg
                        first_air_date:
                          type: string
                          example: '2018-06-20'
                        genre_ids:
                          type: array
                          items:
                            type: number
                            example: 37
                          example:
                            - 37
                            - 18
                        id:
                          type: number
                          example: 73586
                        name:
                          type: string
                          example: Yellowstone
                        origin_country:
                          type: array
                          items:
                            type: string
                            example: US
                          example:
                            - US
                        original_language:
                          type: string
                          example: en
                        original_name:
                          type: string
                          example: Yellowstone
                        overview:
                          type: string
                          example: >-
                            Follow the violent world of the Dutton family, who
                            controls the largest contiguous ranch in the United
                            States. Led by their patriarch John Dutton, the
                            family defends their property against constant
                            attack by land developers, an Indian reservation,
                            and America’s first National Park.
                        popularity:
                          type: number
                          example: 796.839
                        poster_path:
                          type: string
                          example: /s4QRRYc1V2e68Qy9Wel9MI8fhRP.jpg
                        vote_average:
                          type: number
                          example: 8.251
                        vote_count:
                          type: number
                          example: 2671
                    example:
                      - adult: false
                        backdrop_path: /hFFAYkK8XkvIlQss9GYxo8TOhFi.jpg
                        first_air_date: '2018-06-20'
                        genre_ids:
                          - 37
                          - 18
                        id: 73586
                        name: Yellowstone
                        origin_country:
                          - US
                        original_language: en
                        original_name: Yellowstone
                        overview: >-
                          Follow the violent world of the Dutton family, who
                          controls the largest contiguous ranch in the United
                          States. Led by their patriarch John Dutton, the family
                          defends their property against constant attack by land
                          developers, an Indian reservation, and America’s first
                          National Park.
                        popularity: 796.839
                        poster_path: /s4QRRYc1V2e68Qy9Wel9MI8fhRP.jpg
                        vote_average: 8.251
                        vote_count: 2671
                      - adult: false
                        backdrop_path: /zZqpAXxVSBtxV9qPBcscfXBcL2w.jpg
                        first_air_date: '2011-04-17'
                        genre_ids:
                          - 10765
                          - 18
                          - 10759
                        id: 1399
                        name: Game of Thrones
                        origin_country:
                          - US
                        original_language: en
                        original_name: Game of Thrones
                        overview: >-
                          Seven noble families fight for control of the mythical
                          land of Westeros. Friction between the houses leads to
                          full-scale war. All while a very ancient evil awakens
                          in the farthest north. Amidst the war, a neglected
                          military order of misfits, the Night's Watch, is all
                          that stands between the realms of men and icy horrors
                          beyond.
                        popularity: 834.776
                        poster_path: /1XS1oqL89opfnbLl8WnZY1O1uJx.jpg
                        vote_average: 8.456
                        vote_count: 24664
                  total_pages:
                    type: number
                    example: 1
                  total_results:
                    type: number
                    example: 2
              examples:
                Watchlist TV Shows:
                  value:
                    page: 1
                    results:
                      - adult: false
                        backdrop_path: /hFFAYkK8XkvIlQss9GYxo8TOhFi.jpg
                        first_air_date: '2018-06-20'
                        genre_ids:
                          - 37
                          - 18
                        id: 73586
                        name: Yellowstone
                        origin_country:
                          - US
                        original_language: en
                        original_name: Yellowstone
                        overview: >-
                          Follow the violent world of the Dutton family, who
                          controls the largest contiguous ranch in the United
                          States. Led by their patriarch John Dutton, the family
                          defends their property against constant attack by land
                          developers, an Indian reservation, and America’s first
                          National Park.
                        popularity: 796.839
                        poster_path: /s4QRRYc1V2e68Qy9Wel9MI8fhRP.jpg
                        vote_average: 8.251
                        vote_count: 2671
                      - adult: false
                        backdrop_path: /zZqpAXxVSBtxV9qPBcscfXBcL2w.jpg
                        first_air_date: '2011-04-17'
                        genre_ids:
                          - 10765
                          - 18
                          - 10759
                        id: 1399
                        name: Game of Thrones
                        origin_country:
                          - US
                        original_language: en
                        original_name: Game of Thrones
                        overview: >-
                          Seven noble families fight for control of the mythical
                          land of Westeros. Friction between the houses leads to
                          full-scale war. All while a very ancient evil awakens
                          in the farthest north. Amidst the war, a neglected
                          military order of misfits, the Night's Watch, is all
                          that stands between the realms of men and icy horrors
                          beyond.
                        popularity: 834.776
                        poster_path: /1XS1oqL89opfnbLl8WnZY1O1uJx.jpg
                        vote_average: 8.456
                        vote_count: 24664
                    total_pages: 1
                    total_results: 2
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````