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

# Lists

> This endpoint get the lists of user's added movies



## OpenAPI

````yaml get /3/account/{account_id}/lists
openapi: 3.0.3
info:
  title: The Movie Database
  description: Reference
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
security:
  - bearerAuth: []
tags:
  - name: ACCOUNT
  - name: AUTHENTICATION
  - name: CERTIFICATION
  - name: CHANGES
  - name: COLLECTION
  - name: COMPANIES
  - name: CONFIGURATION
  - name: CREDITS
  - name: DISCOVER
  - name: FIND
  - name: GENRES
  - name: GUEST SESSION
  - name: KEYWORDS
  - name: LISTS
  - name: MOVIE LISTS
  - name: MOVIES
  - name: NETWORK
  - name: PEOPLE
  - name: PEOPLE LISTS
  - name: REVIEWS
  - name: SEARCH
  - name: TRENDING
  - name: TV SERIES LIST
  - name: TV SERIES
  - name: TV SEASONS
  - name: TV EPISODES
  - name: TV EPISODES GROUPS
  - name: WATCH PROVIDERS
paths:
  /3/account/{account_id}/lists:
    parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: integer
        description: user's account id
    get:
      tags:
        - ACCOUNT
      summary: Lists
      description: This endpoint get the lists of user's added movies
      operationId: lists
      parameters:
        - name: session_id
          in: query
          schema:
            type: string
            example: ''
          description: session ID for authentication or tracking purposes
        - name: page
          in: query
          schema:
            type: integer
            default: 1
          description: page number to retrieve specific paginated results.
      responses:
        '200':
          description: Lists
          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: Thu, 26 Dec 2024 13:16:22 GMT
            ETag:
              schema:
                type: string
                example: W/"5b333525ff117973180331432dc740b8"
            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 4b0fbb3ec29f742ee0efe0ccfd7e3bd8.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: 5jx0MVjEVKH7YcQH8LpWYi3b8SUW55WW-1Km0J1UvIbppyDYdqDQYQ==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: DFW57-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: 208bf88ef35ae1f415fbf6b385484f09
          content:
            application/json:
              schema:
                type: object
                properties:
                  page:
                    type: number
                    example: 1
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        description:
                          type: string
                          example: This is a story to test this API endpoint
                        favorite_count:
                          type: number
                          example: 0
                        id:
                          type: number
                          example: 8504086
                        iso_639_1:
                          type: string
                          example: en
                        item_count:
                          type: number
                          example: 1
                        list_type:
                          type: string
                          example: movie
                        name:
                          type: string
                          example: True Story Of Nnekka
                        poster_path:
                          nullable: true
                          example: null
                    example:
                      - description: This is a story to test this API endpoint
                        favorite_count: 0
                        id: 8504086
                        iso_639_1: en
                        item_count: 1
                        list_type: movie
                        name: True Story Of Nnekka
                        poster_path: null
                      - description: This is a story to test this API endpoint
                        favorite_count: 0
                        id: 8505816
                        iso_639_1: en
                        item_count: 0
                        list_type: movie
                        name: True Story Of Nnekka
                        poster_path: null
                      - description: Just an awesome list.
                        favorite_count: 0
                        id: 8504985
                        iso_639_1: en
                        item_count: 1
                        list_type: movie
                        name: This is my awesome test list.
                        poster_path: null
                  total_pages:
                    type: number
                    example: 1
                  total_results:
                    type: number
                    example: 3
              examples:
                Lists:
                  value:
                    page: 1
                    results:
                      - description: This is a story to test this API endpoint
                        favorite_count: 0
                        id: 8504086
                        iso_639_1: en
                        item_count: 1
                        list_type: movie
                        name: True Story Of Nnekka
                        poster_path: null
                      - description: This is a story to test this API endpoint
                        favorite_count: 0
                        id: 8505816
                        iso_639_1: en
                        item_count: 0
                        list_type: movie
                        name: True Story Of Nnekka
                        poster_path: null
                      - description: Just an awesome list.
                        favorite_count: 0
                        id: 8504985
                        iso_639_1: en
                        item_count: 1
                        list_type: movie
                        name: This is my awesome test list.
                        poster_path: null
                    total_pages: 1
                    total_results: 3
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````