> ## Documentation Index
> Fetch the complete documentation index at: https://tvc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Lists

> This endpoint gets the lists that a TV series has been added to.



## OpenAPI

````yaml get /3/tv/{{series_id}}/lists
openapi: 3.0.3
info:
  title: TMDb Endpoints
  description: >-
    Welcome to the TMDb API! You'll find a well-organized collection of
    endpoints, each helping you fetch different types of movie and TV data. The
    endpoints cover everything from searching for titles and getting details to
    managing lists and accessing ratings, all designed to give you precise
    control over the information you need.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
    description: Test server
  - url: https://api.themoviedb.org/3
    description: Production server
  - url: '{{base_url}}'
    description: Some other server
security: []
tags:
  - name: AUTHENTICATION
    description: The /account/{account_id} gets the public details of an account on TMDB.
  - name: ACCOUNT
    description: >-
      Account endpoints allow users to manage their personal information,
      ratings, watchlists, and other account-related data after authenticating.
  - name: CERTIFICATIONS
    description: >-
      The Certifications endpoints provide lists of movie and TV show content
      rating systems used in various countries.
  - name: CHANGES
    description: >-
      Changes endpoints allow you to track modifications made to movies, TV
      shows, and people in the TMDb database, providing a history of updates and
      enabling you to keep your local data synchronized.
  - name: COLLECTIONS
  - name: COMPANIES
  - name: CONFIGURATION
  - name: CREDITS
  - name: DISCOVER
    description: >-
      Discover endpoints are powerful tools for finding movies and TV shows
      based on a wide range of criteria, such as genre, release date, rating,
      keywords, and more, enabling highly customized searches.
  - name: FIND
    description: This folder has find by ID endpoint
  - name: GENRES
    description: >-
      Genres endpoints provide lists of available movie and TV show genres,
      allowing you to categorize and filter content.
  - name: GUEST SESSIONS
    description: >-
      Guest session endpoints allow you to create temporary, unauthenticated
      sessions that grant limited access to certain API features, such as rating
      movies or TV shows without requiring a full user account.
  - name: KEYWORDS
    description: >-
      Keyword endpoints allow you to search for keywords and retrieve detailed
      information about specific keywords and the media associated with them.
  - name: LISTS
    description: >-
      Lists endpoints allow you to create, retrieve, modify, and delete custom
      lists of movies or TV shows.
  - name: MOVIE LIST
    description: >-
      The Movie List endpoints let you retrieve pre-made lists of movies,
      categorized by criteria like popularity, top rated, now playing, or
      upcoming releases.
  - name: MOVIES
    description: >-
      The Movie endpoints allow you to retrieve detailed information about
      movies, including titles, descriptions, cast, crew, ratings, and related
      data.
  - name: NETWORKS
    description: >-
      The NETWORKS endpoints let you retrieve information about television
      networks, such as their names, logos, and origin countries.
  - name: PEOPLE LISTS
    description: >-
      The People Lists endpoints let you retrieve lists of people based on
      criteria like popularity.
  - name: PEOPLE
    description: >-
      The PEOPLE endpoints let you get information about actors, directors, and
      other people involved in movies and TV shows.
  - name: REVIEWS
    description: >-
      The REVIEWS endpoints let you get user-written opinions and ratings about
      movies and TV shows.
  - name: SEARCH
    description: >-
      The "Search" endpoints let you find movies, TV shows, people, and other
      content by typing in keywords or names.
  - name: TRENDING
    description: >-
      The "Trending" endpoints show you what movies, TV shows, and people are
      currently popular or getting a lot of attention right now.
  - name: TV SERIES LISTS
    description: >-
      TV Series Lists endpoints provide access to pre-defined lists of TV shows,
      such as popular, top-rated, or airing today, allowing you to quickly
      retrieve collections of TV series based on specific criteria.
  - name: TV SERIES
    description: >-
      The TV series endpoints provide access to a wealth of information about
      television shows, including details, credits, seasons, episodes,
      recommendations, and more. See each of them below for specific
      information.
  - name: TV SEASONS
    description: >-
      The TV seasons endpoints allow you to retrieve details about specific
      seasons of a TV show, including information about the episodes within that
      season. See them below for specific information on how to use them.
  - name: TV EPISODES
    description: >-
      The TV episode endpoints allow you to retrieve detailed information about
      specific episodes of a TV show, including details like the episode number,
      name, air date, overview, and more. Check them out for specific
      information.
  - name: TV EPISODE GROUPS
    description: >-
      There's only one endpoint in this folder. Check the endpoint to find
      information about it.
  - name: WATCH PROVIDERS
    description: >-
      The Watch Providers endpoints provide information about streaming
      services, rental/purchase platforms, and sometimes even theatrical
      releases in different regions.
paths:
  /3/tv/{{series_id}}/lists:
    parameters:
      - name: series_id
        in: path
        required: true
        schema:
          type: string
    get:
      tags:
        - TV SERIES
      summary: Lists
      description: This endpoint gets the lists that a TV series has been added to.
      operationId: lists2
      responses:
        '200':
          description: Lists Example
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=27954
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Sun, 12 Jan 2025 17:14:06 GMT
            ETag:
              schema:
                type: string
                example: W/"b4a25f0b385fa3eb3a92161fc406af10"
            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 e9e1982b26fa05631ca01b6aee8693be.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: B71P4qLT-W-9p8J7y7k-gQFQr5LDmqCndqLHImSNQUiaadhaBAePpw==
            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: HIT
            x-memc-age:
              schema:
                type: string
                example: '54'
            x-memc-expires:
              schema:
                type: string
                example: '27954'
            x-memc-key:
              schema:
                type: string
                example: 17264c03b2ac56a4cc9d9d53b5e54837
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: number
                    example: 1399
                  page:
                    type: number
                    example: 1
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        description:
                          type: string
                          example: ''
                        favorite_count:
                          type: number
                          example: 0
                        id:
                          type: number
                          example: 8506676
                        iso_3166_1:
                          type: string
                          example: US
                        iso_639_1:
                          type: string
                          example: en
                        item_count:
                          type: number
                          example: 6
                        name:
                          type: string
                          example: 'series '
                        poster_path:
                          nullable: true
                          example: null
                    example:
                      - description: ''
                        favorite_count: 0
                        id: 8506676
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 6
                        name: 'series '
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8504015
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 16
                        name: zzz
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8503540
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 17
                        name: Favorite
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8500907
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 407
                        name: Watched
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8250820
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 746
                        name: watched
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8502269
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 8
                        name: WÃF
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8257231
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 193
                        name: Done
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8258601
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 218
                        name: All
                        poster_path: null
                      - description: hamza
                        favorite_count: 0
                        id: 8505875
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 11
                        name: 'movie and series '
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8173010
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 618
                        name: SERIES
                        poster_path: null
                      - description: 'Denisse no sabe que ver '
                        favorite_count: 0
                        id: 8505748
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 36
                        name: Movies for Denisse
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8505843
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 75
                        name: Series I've watched
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 94505
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 161
                        name: Television Shows I've Seen
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8504740
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 16
                        name: 'best '
                        poster_path: null
                      - description: 'winter is coming '
                        favorite_count: 0
                        id: 8502009
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 13
                        name: 🌕
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8214785
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 52
                        name: TV series
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8430281
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 9
                        name: AMLASHI
                        poster_path: null
                      - description: >-
                          Television Series of which I have watched one or more
                          complete seasons.
                        favorite_count: 0
                        id: 8193811
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 555
                        name: Television Series
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8504261
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 75
                        name: TV SHOWS Library
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 38085
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 34
                        name: TV Series
                        poster_path: null
                  total_pages:
                    type: number
                    example: 104
                  total_results:
                    type: number
                    example: 2077
              examples:
                Lists Example:
                  value:
                    id: 1399
                    page: 1
                    results:
                      - description: ''
                        favorite_count: 0
                        id: 8506676
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 6
                        name: 'series '
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8504015
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 16
                        name: zzz
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8503540
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 17
                        name: Favorite
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8500907
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 407
                        name: Watched
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8250820
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 746
                        name: watched
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8502269
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 8
                        name: WÃF
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8257231
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 193
                        name: Done
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8258601
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 218
                        name: All
                        poster_path: null
                      - description: hamza
                        favorite_count: 0
                        id: 8505875
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 11
                        name: 'movie and series '
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8173010
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 618
                        name: SERIES
                        poster_path: null
                      - description: 'Denisse no sabe que ver '
                        favorite_count: 0
                        id: 8505748
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 36
                        name: Movies for Denisse
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8505843
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 75
                        name: Series I've watched
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 94505
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 161
                        name: Television Shows I've Seen
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8504740
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 16
                        name: 'best '
                        poster_path: null
                      - description: 'winter is coming '
                        favorite_count: 0
                        id: 8502009
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 13
                        name: 🌕
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8214785
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 52
                        name: TV series
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8430281
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 9
                        name: AMLASHI
                        poster_path: null
                      - description: >-
                          Television Series of which I have watched one or more
                          complete seasons.
                        favorite_count: 0
                        id: 8193811
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 555
                        name: Television Series
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 8504261
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 75
                        name: TV SHOWS Library
                        poster_path: null
                      - description: ''
                        favorite_count: 0
                        id: 38085
                        iso_3166_1: US
                        iso_639_1: en
                        item_count: 34
                        name: TV Series
                        poster_path: null
                    total_pages: 104
                    total_results: 2077
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````