> ## Documentation Index > Fetch the complete documentation index at: https://chisa.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Rated TV > Get a users list of rated TV shows. ## OpenAPI ````yaml api-reference/openapi.json get /3/account/{{account_id}}/rated/tv openapi: 3.0.3 info: title: Themoviedb API description: >- Version 3 (stable) of The Movie Database (TMDB) API offers a concise list of available methods for movies, TV shows, actors, and images. version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org - url: https://api.themoviedb.org/3 security: [] tags: - name: Account - name: Authentication description: >- # How do I generate a session id? As outlined in the [getting started guide](https://developer.themoviedb.org/docs/getting-started), the basics to getting a user authenticated look like this: 1. **Create a new request token** 2. **Get the user to authorize the request token** 3. **Create a new session id with the authorized request token** Steps 1 and 3 should be fairly easy to understand, but let's walk through each to ensure clarity. ## Step 1: Create a request token The first step as a developer is to request a new token. This is a **temporary token** required to ask the user for permission to access their account. This token will automatically expire **after 60 minutes** if it's not used. ## Step 2: Ask the user for permission With a request token in hand, forward your user to the following URL: ``` https://www.themoviedb.org/authenticate/{REQUEST_TOKEN} ``` You can also pass this URL a `redirect_to` parameter, like so: ``` https://www.themoviedb.org/authenticate/{REQUEST_TOKEN}?redirect_to=http://www.yourapp.com/approved ``` Once the user has approved your request token, they will either be redirected to the URL you specified in the `redirect_to` parameter or to the `/authenticate/allow` path on TMDB. If they aren't redirected to a custom URL, the page will also include an `Authentication-Callback` header. This header contains the API call for step #3. You can either manually generate it or simply use the one we return. ## Step 3: Create a session ID By calling the **new session method** with the request token that has been approved by the user in Step 2, we will return a **new session_id**. This session can now be used to write user data. You should treat this key **like a password** and keep it secret. ## What about guest sessions? A **guest session** can be used to rate movies **without** requiring a registered TMDB user account. For more information about how to create a guest session, see [here](https://developer.themoviedb.org/docs/authentication). - name: Certification - name: Changes - name: Collections - name: Companies - name: Configuration - name: Credits - name: Discover - name: Find - name: Genres - name: Guest Session - name: Keywords - name: List description: >- ## v3 or v4 list? 😕 You may have noticed that the a v4 version of our list API exists. While these v3 list methods continue to work, all of the new features you can see on our website are only available if you switch to the v4 lists. **What are some of the improvements in v4?** - You can import "unlimited" items in a single request - You can use mixed type (movie and TV) lists - You can use private lists - You can add and use comments per item - There are more sort options - They are faster - Check the v4 documentation for more information. - name: Movie Lists - name: Movies - name: Networks - name: People Lists - name: People - name: Reviews - name: Search - name: Trending - name: TV Series Lists - name: TV Series - name: TV Seasons - name: TV Episodes - name: TV Episode Groups - name: Watch Providers paths: /3/account/{{account_id}}/rated/tv: parameters: - name: account_id in: path required: true schema: type: string get: tags: - Account summary: Rated TV description: Get a users list of rated TV shows. operationId: ratedTv parameters: - name: language in: query schema: type: string example: en-US - name: page in: query schema: type: string example: '1' - name: sort_by in: query schema: type: string example: created_at.asc responses: '200': description: R_TV 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: Fri, 03 Jan 2025 20:39:10 GMT ETag: schema: type: string example: W/"eaf489491cf5a97860f621fc315eac0f" 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 3502b4da22916485af0d3edbb185fb9c.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: aHKwqEgSYmWyaHzLPCO6DGeg2oy73ktewvD5IPQAKZvIlT99m7HpMw== 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: b100f2cb6fd35837f94251ce233e67d6 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: /2w8FaLwwJTWr6ExUMeVgT2Th5YT.jpg first_air_date: type: string example: '2000-10-03' genre_ids: type: array items: type: number example: 16 example: - 16 - 35 - 18 - 10759 id: type: number example: 42705 name: type: string example: Fighting Spirit origin_country: type: array items: type: string example: JP example: - JP original_language: type: string example: ja original_name: type: string example: はじめの一歩 overview: type: string example: >- Makunouchi Ippo is an ordinary high school student in Japan. Since he spends most of his time away from school helping his mother run the family business, he doesn't get to enjoy his younger years like most teenagers. Always a target for bullying at school (the family fishing business grants him a distinct odor), Ippo's life is one of hardship. One of these after-school bullying sessions turns Ippo's life around for the better, as he is saved by a boxer named Takamura. He decides to follow in Takamura's footsteps and train to become a boxer, giving his life direction and purpose. Ippo's path to perfecting his pugilistic prowess is just beginning... popularity: type: number example: 1484.436 poster_path: type: string example: /qC4taY6yB9BWJ8IxcbnXR8yUS4o.jpg rating: type: number example: 10 vote_average: type: number example: 8.657 vote_count: type: number example: 1086 example: - adult: false backdrop_path: /2w8FaLwwJTWr6ExUMeVgT2Th5YT.jpg first_air_date: '2000-10-03' genre_ids: - 16 - 35 - 18 - 10759 id: 42705 name: Fighting Spirit origin_country: - JP original_language: ja original_name: はじめの一歩 overview: >- Makunouchi Ippo is an ordinary high school student in Japan. Since he spends most of his time away from school helping his mother run the family business, he doesn't get to enjoy his younger years like most teenagers. Always a target for bullying at school (the family fishing business grants him a distinct odor), Ippo's life is one of hardship. One of these after-school bullying sessions turns Ippo's life around for the better, as he is saved by a boxer named Takamura. He decides to follow in Takamura's footsteps and train to become a boxer, giving his life direction and purpose. Ippo's path to perfecting his pugilistic prowess is just beginning... popularity: 1484.436 poster_path: /qC4taY6yB9BWJ8IxcbnXR8yUS4o.jpg rating: 10 vote_average: 8.657 vote_count: 1086 - adult: false backdrop_path: /oUmWLyeko3kYdUr8DBLIsxwcugl.jpg first_air_date: '2024-10-11' genre_ids: - 16 - 10759 - 35 - 10765 id: 236994 name: Dragon Ball DAIMA origin_country: - JP original_language: ja original_name: ドラゴンボールDAIMA overview: >- Mysteriously transformed into mini versions of themselves, Goku and his friends travel to the Demon Realm to uncover the truth and find a cure. popularity: 526.944 poster_path: /cIDPZMGsiVHkHA6HPJmEmGcgyyw.jpg rating: 10 vote_average: 8.204 vote_count: 265 - adult: false backdrop_path: /or7wKwv1IT6LEOktt395O5qi7e.jpg first_air_date: '2013-09-12' genre_ids: - 18 - 80 id: 60574 name: Peaky Blinders origin_country: - GB original_language: en original_name: Peaky Blinders overview: >- A gangster family epic set in 1919 Birmingham, England and centered on a gang who sew razor blades in the peaks of their caps, and their fierce boss Tommy Shelby, who means to move up in the world. popularity: 484.899 poster_path: /vUUqzWa2LnHIVqkaKVlVGkVcZIW.jpg rating: 10 vote_average: 8.538 vote_count: 10056 total_pages: type: number example: 1 total_results: type: number example: 3 examples: R_TV: value: page: 1 results: - adult: false backdrop_path: /2w8FaLwwJTWr6ExUMeVgT2Th5YT.jpg first_air_date: '2000-10-03' genre_ids: - 16 - 35 - 18 - 10759 id: 42705 name: Fighting Spirit origin_country: - JP original_language: ja original_name: はじめの一歩 overview: >- Makunouchi Ippo is an ordinary high school student in Japan. Since he spends most of his time away from school helping his mother run the family business, he doesn't get to enjoy his younger years like most teenagers. Always a target for bullying at school (the family fishing business grants him a distinct odor), Ippo's life is one of hardship. One of these after-school bullying sessions turns Ippo's life around for the better, as he is saved by a boxer named Takamura. He decides to follow in Takamura's footsteps and train to become a boxer, giving his life direction and purpose. Ippo's path to perfecting his pugilistic prowess is just beginning... popularity: 1484.436 poster_path: /qC4taY6yB9BWJ8IxcbnXR8yUS4o.jpg rating: 10 vote_average: 8.657 vote_count: 1086 - adult: false backdrop_path: /oUmWLyeko3kYdUr8DBLIsxwcugl.jpg first_air_date: '2024-10-11' genre_ids: - 16 - 10759 - 35 - 10765 id: 236994 name: Dragon Ball DAIMA origin_country: - JP original_language: ja original_name: ドラゴンボールDAIMA overview: >- Mysteriously transformed into mini versions of themselves, Goku and his friends travel to the Demon Realm to uncover the truth and find a cure. popularity: 526.944 poster_path: /cIDPZMGsiVHkHA6HPJmEmGcgyyw.jpg rating: 10 vote_average: 8.204 vote_count: 265 - adult: false backdrop_path: /or7wKwv1IT6LEOktt395O5qi7e.jpg first_air_date: '2013-09-12' genre_ids: - 18 - 80 id: 60574 name: Peaky Blinders origin_country: - GB original_language: en original_name: Peaky Blinders overview: >- A gangster family epic set in 1919 Birmingham, England and centered on a gang who sew razor blades in the peaks of their caps, and their fierce boss Tommy Shelby, who means to move up in the world. popularity: 484.899 poster_path: /vUUqzWa2LnHIVqkaKVlVGkVcZIW.jpg rating: 10 vote_average: 8.538 vote_count: 10056 total_pages: 1 total_results: 3 ````