> ## 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 custom lists that a user has created. ## OpenAPI ````yaml get /4/account/{account_object_id}/lists 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}/lists: parameters: - name: account_object_id in: path required: true schema: type: string example: 676a950bf68dc118f77ecc2a get: tags: - ACCOUNT summary: Lists description: This endpoint get the custom lists that a user has created. operationId: lists parameters: - name: page description: the page number in: query schema: type: integer default: 1 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, 27 Feb 2025 10:57:33 GMT ETag: schema: type: string example: W/"7fc0d84cec54631dd640fbd17865ca59" 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 f4f3f118ac6f8aab6b0b8776a3481c6e.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: H0RslKImGQHXEVECwoV-mMA2OPkY8n6508xek_030LTrZzius91U_Q== 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: 33730b97a029ee414ebc815cab40e5cc content: application/json: schema: type: object properties: page: type: number example: 1 results: type: array items: type: object properties: account_object_id: type: string example: 676a950bf68dc118f77ecc2a adult: type: number example: 0 average_rating: type: number example: 0 backdrop_path: nullable: true example: null created_at: type: string example: 2025-02-04 17:24:37 UTC description: type: string example: This is a guide in testing this API endpoint featured: type: number example: 0 id: type: number example: 8510518 iso_3166_1: type: string example: US iso_639_1: type: string example: en name: type: string example: API documentation number_of_items: type: number example: 0 poster_path: nullable: true example: null public: type: number example: 1 revenue: type: number example: 0 runtime: type: string example: '0' sort_by: type: number example: 1 updated_at: type: string example: 2025-02-04 17:24:37 UTC example: - account_object_id: 676a950bf68dc118f77ecc2a adult: 0 average_rating: 0 backdrop_path: null created_at: 2025-02-04 17:24:37 UTC description: This is a guide in testing this API endpoint featured: 0 id: 8510518 iso_3166_1: US iso_639_1: en name: API documentation number_of_items: 0 poster_path: null public: 1 revenue: 0 runtime: '0' sort_by: 1 updated_at: 2025-02-04 17:24:37 UTC - account_object_id: 676a950bf68dc118f77ecc2a adult: 0 average_rating: 0 backdrop_path: null created_at: 2025-01-27 09:43:27 UTC description: This is a story to test this API endpoint featured: 0 id: 8509236 iso_3166_1: US iso_639_1: en name: True Story Of Nnekka number_of_items: 0 poster_path: null public: 1 revenue: 0 runtime: '0' sort_by: 1 updated_at: 2025-01-27 09:43:27 UTC - account_object_id: 676a950bf68dc118f77ecc2a adult: 0 average_rating: 7.9 backdrop_path: null created_at: 2024-12-30 08:59:43 UTC description: This is a story to test this API endpoint featured: 0 id: 8504086 iso_3166_1: US iso_639_1: en name: True Story Of Nnekka number_of_items: 1 poster_path: null public: 1 revenue: 40061153 runtime: '140' sort_by: 1 updated_at: 2025-01-27 09:43:10 UTC - account_object_id: 676a950bf68dc118f77ecc2a adult: 0 average_rating: 0 backdrop_path: null created_at: 2025-01-08 03:05:46 UTC description: This is a story to test this API endpoint featured: 0 id: 8505816 iso_3166_1: US iso_639_1: en name: True Story Of Nnekka number_of_items: 0 poster_path: null public: 1 revenue: 0 runtime: '0' sort_by: 1 updated_at: 2025-01-08 03:05:46 UTC - account_object_id: 676a950bf68dc118f77ecc2a adult: 0 average_rating: 7.6 backdrop_path: null created_at: 2025-01-03 19:30:29 UTC description: Just an awesome list. featured: 0 id: 8504985 iso_3166_1: US iso_639_1: en name: This is my awesome test list. number_of_items: 1 poster_path: null public: 1 revenue: 263920180 runtime: '126' sort_by: 1 updated_at: 2025-01-03 19:32:07 UTC total_pages: type: number example: 1 total_results: type: number example: 5 examples: Lists: value: page: 1 results: - account_object_id: 676a950bf68dc118f77ecc2a adult: 0 average_rating: 0 backdrop_path: null created_at: 2025-02-04 17:24:37 UTC description: This is a guide in testing this API endpoint featured: 0 id: 8510518 iso_3166_1: US iso_639_1: en name: API documentation number_of_items: 0 poster_path: null public: 1 revenue: 0 runtime: '0' sort_by: 1 updated_at: 2025-02-04 17:24:37 UTC - account_object_id: 676a950bf68dc118f77ecc2a adult: 0 average_rating: 0 backdrop_path: null created_at: 2025-01-27 09:43:27 UTC description: This is a story to test this API endpoint featured: 0 id: 8509236 iso_3166_1: US iso_639_1: en name: True Story Of Nnekka number_of_items: 0 poster_path: null public: 1 revenue: 0 runtime: '0' sort_by: 1 updated_at: 2025-01-27 09:43:27 UTC - account_object_id: 676a950bf68dc118f77ecc2a adult: 0 average_rating: 7.9 backdrop_path: null created_at: 2024-12-30 08:59:43 UTC description: This is a story to test this API endpoint featured: 0 id: 8504086 iso_3166_1: US iso_639_1: en name: True Story Of Nnekka number_of_items: 1 poster_path: null public: 1 revenue: 40061153 runtime: '140' sort_by: 1 updated_at: 2025-01-27 09:43:10 UTC - account_object_id: 676a950bf68dc118f77ecc2a adult: 0 average_rating: 0 backdrop_path: null created_at: 2025-01-08 03:05:46 UTC description: This is a story to test this API endpoint featured: 0 id: 8505816 iso_3166_1: US iso_639_1: en name: True Story Of Nnekka number_of_items: 0 poster_path: null public: 1 revenue: 0 runtime: '0' sort_by: 1 updated_at: 2025-01-08 03:05:46 UTC - account_object_id: 676a950bf68dc118f77ecc2a adult: 0 average_rating: 7.6 backdrop_path: null created_at: 2025-01-03 19:30:29 UTC description: Just an awesome list. featured: 0 id: 8504985 iso_3166_1: US iso_639_1: en name: This is my awesome test list. number_of_items: 1 poster_path: null public: 1 revenue: 263920180 runtime: '126' sort_by: 1 updated_at: 2025-01-03 19:32:07 UTC total_pages: 1 total_results: 5 components: securitySchemes: bearerAuth: type: http scheme: bearer ````