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

# Lists

> This endpoint is used to get the custom lists that a user has created.




## OpenAPI

````yaml get /4/account/{account_object_id}/lists
openapi: 3.0.3
info:
  title: TMDB API DOCUMENTATION
  description: >-
    The Movie Database is an API that provides comprehensive movie, TV show, and
    celebrity data. TMDB offers APIs that developers use to access and integrate
    its data into applications, websites, or services.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org/3
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Endpoints for managing authentication, including login and user sessions.
  - name: Account
    description: Endpoints for managing user accounts, such as profiles and settings.
  - name: Certification
    description: Endpoints for retrieving and managing certification data.
  - name: Changes
    description: Endpoints for tracking changes and updates across the system.
  - name: Collection
    description: Endpoints for managing and accessing user collections.
  - name: Companies
    description: Endpoints for retrieving and managing company-related data.
  - name: Configuration
    description: Endpoints for accessing and updating system configuration settings.
  - name: Credits
    description: Endpoints for retrieving credit information related to movies or shows.
  - name: Discover
    description: Endpoints for discovering content based on filters and criteria.
  - name: Find
    description: Endpoints for locating specific items or entities in the database.
  - name: Genres
    description: Endpoints for retrieving and managing genres for categorization.
  - name: Guest Sessions
    description: Endpoints for creating and managing guest user sessions.
  - name: Keywords
    description: Endpoints for managing and searching content using keywords.
  - name: Lists
    description: Endpoints for creating and managing user-generated lists.
  - name: Movie Lists
    description: Endpoints for retrieving and managing lists of movies.
  - name: Movies
    description: Endpoints for retrieving detailed information about movies.
  - name: Networks
    description: Endpoints for retrieving and managing network-related data.
  - name: People Lists
    description: Endpoints for retrieving and managing lists of people in the system.
  - name: People
    description: Endpoints for retrieving information about actors, directors, and others.
  - name: Search
    description: Endpoints for performing searches across multiple categories.
  - name: Reviews
    description: Endpoints for managing and displaying reviews from users.
  - name: Trending
    description: Endpoints for retrieving trending content based on popularity.
  - name: TV Series Lists
    description: Endpoints for retrieving and managing lists of TV series.
  - name: TV Series
    description: Endpoints for retrieving detailed information about TV series.
  - name: TV Seasons
    description: Endpoints for retrieving and managing information about TV seasons.
  - name: TV Episodes
    description: Endpoints for retrieving and managing information about TV episodes.
  - name: TV Episode Groups
    description: Endpoints for managing groups of TV episodes organized by criteria.
  - name: Watch Providers
    description: >-
      Endpoints for retrieving availability information from streaming
      providers.
  - name: Auth
    description: >-
      Endpoints for managing version4 authentication, including login and user
      sessions.
  - name: Lists
    description: >-
      Endpoints for managing version4 authentication, including login and user
      sessions.
paths:
  /4/account/{account_object_id}/lists:
    get:
      tags:
        - Account
      summary: Lists
      description: |
        This endpoint is used to get the custom lists that a user has created.
      operationId: v4List
      parameters:
        - name: account_object_id
          in: path
          required: true
          description: The account object ID.
          schema:
            type: string
        - name: page
          in: query
          required: false
          description: The page number of a list.
          schema:
            type: integer
      responses:
        '200':
          description: Successful
          content:
            application/json;charset=utf-8:
              schema:
                type: object
                properties:
                  page:
                    type: integer
                    description: The current page number in the paginated response.
                  results:
                    type: array
                    description: A list of movie or TV show objects.
                    items:
                      type: object
                      properties:
                        account_object_id:
                          type: string
                          description: >-
                            The unique ID of the account associated with the
                            list.
                        adult:
                          type: boolean
                          description: >-
                            Indicates whether the content is for adults (true)
                            or not (false).
                        average_rating:
                          type: number
                          format: float
                          description: >-
                            The average rating of the list's items, if
                            applicable.
                        backdrop_path:
                          type: string
                          nullable: true
                          description: >-
                            The file path for the backdrop image associated with
                            the list.
                        created_at:
                          type: string
                          format: date-time
                          description: >-
                            The date and time when the list was created (UTC
                            format).
                        description:
                          type: string
                          description: A short description of the list.
                        featured:
                          type: boolean
                          description: >-
                            Indicates whether the list is featured (true) or not
                            (false).
                        id:
                          type: integer
                          description: The unique identifier for the list.
                        iso_3166_1:
                          type: string
                          description: >-
                            The country code (ISO 3166-1) associated with the
                            list.
                        iso_639_1:
                          type: string
                          description: The language code (ISO 639-1) of the list.
                        name:
                          type: string
                          description: The name of the list.
                        number_of_items:
                          type: integer
                          description: The total number of items in the list.
                        poster_path:
                          type: string
                          nullable: true
                          description: >-
                            The file path for the poster image associated with
                            the list.
                        public:
                          type: boolean
                          description: >-
                            Indicates whether the list is public (true) or
                            private (false).
                        revenue:
                          type: integer
                          description: >-
                            The total revenue generated by the movies in the
                            list (if applicable).
                        runtime:
                          type: string
                          description: >-
                            The total runtime of the movies in the list (if
                            applicable).
                        sort_by:
                          type: integer
                          description: Sorting order of the list.
                        updated_at:
                          type: string
                          format: date-time
                          description: >-
                            The date and time when the list was last updated
                            (UTC format).
                  total_pages:
                    type: integer
                    description: The total number of pages available for the list.
                  total_results:
                    type: integer
                    description: The total number of results returned.
                example:
                  results:
                    - account_object_id: 62f6e4aef92532007e99d09b
                      adult: 0
                      average_rating: 0
                      backdrop_path: null
                      created_at: 2025-01-02 15:41:28 UTC
                      description: Just an awesome list.
                      featured: 0
                      id: 8504752
                      iso_3166_1: US
                      iso_639_1: en
                      name: This is my awesome test list.
                      number_of_items: 0
                      poster_path: null
                      public: 1
                      revenue: 0
                      runtime: '0'
                      sort_by: 1
                      updated_at: 2025-01-02 15:41:28 UTC
                  total_pages: 1
                  total_results: 1
      servers:
        - url: https://api.themoviedb.org
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.