> ## 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. # Details > Get the details of a TV show. ## OpenAPI ````yaml api-reference/openapi.json get /3/tv/{{series_id}} 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/tv/{{series_id}}: parameters: - name: series_id in: path required: true schema: type: string get: tags: - TV Series summary: Details description: Get the details of a TV show. operationId: details10 parameters: - name: language in: query schema: type: string example: en-US responses: '200': description: Details headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=21385 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Fri, 10 Jan 2025 20:47:56 GMT ETag: schema: type: string example: W/"9dc1f60ef99b6acc665d9f66496f0f0d" 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 7e9e069e30b25fca38d3949c59e59802.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: cMQTVxFwq9GoWD7X6-m3b0cET_Sj24kSVBCJI5gQKEn945yDMjUIcw== 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: '3424' x-memc-expires: schema: type: string example: '21385' x-memc-key: schema: type: string example: 0ed4eea173d05b9230865214485d8a0f content: application/json: schema: type: object properties: adult: type: boolean example: false backdrop_path: type: string example: /gc8PfyTqzqltKPW3X0cIVUGmagz.jpg created_by: type: array items: type: object properties: credit_id: type: string example: 52542286760ee31328001a7b gender: type: number example: 2 id: type: number example: 66633 name: type: string example: Vince Gilligan original_name: type: string example: Vince Gilligan profile_path: type: string example: /z3E0DhBg1V1PZVEtS9vfFPzOWYB.jpg example: - credit_id: 52542286760ee31328001a7b gender: 2 id: 66633 name: Vince Gilligan original_name: Vince Gilligan profile_path: /z3E0DhBg1V1PZVEtS9vfFPzOWYB.jpg episode_run_time: type: array items: {} example: [] first_air_date: type: string example: '2008-01-20' genres: type: array items: type: object properties: id: type: number example: 18 name: type: string example: Drama example: - id: 18 name: Drama - id: 80 name: Crime homepage: type: string example: https://www.sonypictures.com/tv/breakingbad id: type: number example: 1396 in_production: type: boolean example: false languages: type: array items: type: string example: en example: - en - de - es last_air_date: type: string example: '2013-09-29' last_episode_to_air: type: object properties: air_date: type: string example: '2013-09-29' episode_number: type: number example: 16 episode_type: type: string example: finale id: type: number example: 62161 name: type: string example: Felina overview: type: string example: All bad things must come to an end. production_code: type: string example: '' runtime: type: number example: 56 season_number: type: number example: 5 show_id: type: number example: 1396 still_path: type: string example: /pA0YwyhvdDXP3BEGL2grrIhq8aM.jpg vote_average: type: number example: 9.223 vote_count: type: number example: 222 name: type: string example: Breaking Bad networks: type: array items: type: object properties: id: type: number example: 174 logo_path: type: string example: /pmvRmATOCaDykE6JrVoeYxlFHw3.png name: type: string example: AMC origin_country: type: string example: US example: - id: 174 logo_path: /pmvRmATOCaDykE6JrVoeYxlFHw3.png name: AMC origin_country: US next_episode_to_air: nullable: true example: null number_of_episodes: type: number example: 62 number_of_seasons: type: number example: 5 origin_country: type: array items: type: string example: US example: - US original_language: type: string example: en original_name: type: string example: Breaking Bad overview: type: string example: >- Walter White, a New Mexico chemistry teacher, is diagnosed with Stage III cancer and given a prognosis of only two years left to live. He becomes filled with a sense of fearlessness and an unrelenting desire to secure his family's financial future at any cost as he enters the dangerous world of drugs and crime. popularity: type: number example: 842.173 poster_path: type: string example: /ztkUQFLlC19CCMYHW9o1zWhJRNq.jpg production_companies: type: array items: type: object properties: id: type: number example: 11073 logo_path: type: string nullable: true example: /aCbASRcI1MI7DXjPbSW9Fcv9uGR.png name: type: string example: Sony Pictures Television origin_country: type: string example: US example: - id: 11073 logo_path: /aCbASRcI1MI7DXjPbSW9Fcv9uGR.png name: Sony Pictures Television origin_country: US - id: 33742 logo_path: null name: High Bridge Productions origin_country: US - id: 2605 logo_path: null name: Gran Via Productions origin_country: US production_countries: type: array items: type: object properties: iso_3166_1: type: string example: US name: type: string example: United States of America example: - iso_3166_1: US name: United States of America seasons: type: array items: type: object properties: air_date: type: string example: '2009-02-17' episode_count: type: number example: 9 id: type: number example: 3577 name: type: string example: Specials overview: type: string example: '' poster_path: type: string example: /40dT79mDEZwXkQiZNBgSaydQFDP.jpg season_number: type: number example: 0 vote_average: type: number example: 0 example: - air_date: '2009-02-17' episode_count: 9 id: 3577 name: Specials overview: '' poster_path: /40dT79mDEZwXkQiZNBgSaydQFDP.jpg season_number: 0 vote_average: 0 - air_date: '2008-01-20' episode_count: 7 id: 3572 name: Season 1 overview: >- High school chemistry teacher Walter White's life is suddenly transformed by a dire medical diagnosis. Street-savvy former student Jesse Pinkman "teaches" Walter a new trade. poster_path: /1BP4xYv9ZG4ZVHkL7ocOziBbSYH.jpg season_number: 1 vote_average: 8.3 - air_date: '2009-03-08' episode_count: 13 id: 3573 name: Season 2 overview: >- Walt must deal with the chain reaction of his choice, as he and Jesse face new and severe consequences. When danger and suspicion around Walt escalate, he is pushed to new levels of desperation. Just how much higher will the stakes rise? How far is Walt willing to go to ensure his family's security? Will his grand plan spiral out of control? poster_path: /e3oGYpoTUhOFK0BJfloru5ZmGV.jpg season_number: 2 vote_average: 8.4 - air_date: '2010-03-21' episode_count: 13 id: 3575 name: Season 3 overview: >- Walt continues to battle dueling identities: a desperate husband and father trying to provide for his family, and a newly appointed key player in the Albuquerque drug trade. As the danger around him escalates, Walt is now entrenched in the complex worlds of an angst-ridden family on the verge of dissolution, and the ruthless and unrelenting drug cartel. poster_path: /ffP8Q8ew048YofHRnFVM18B2fPG.jpg season_number: 3 vote_average: 8.4 - air_date: '2011-07-17' episode_count: 13 id: 3576 name: Season 4 overview: >- Walt and Jesse must cope with the fallout of their previous actions, both personally and professionally. Tension mounts as Walt faces a true standoff with his employer, Gus, with neither side willing or able to back down. Walt must also adjust to a new relationship with Skyler, whom while still reconciling her relationship with Walt, is committed to properly laundering Walt’s money and ensuring her sister Marie and an ailing Hank are financially stable. poster_path: /5ewrnKp4TboU4hTLT5cWO350mHj.jpg season_number: 4 vote_average: 8.5 - air_date: '2012-07-15' episode_count: 16 id: 3578 name: Season 5 overview: "Walt is faced with the prospect of moving on in a world without his enemy. As the pressure of a criminal life starts to build, Skyler struggles to keep Walt’s terrible secrets. Facing resistance from sometime adversary and former Fring lieutenant Mike, Walt tries to keep his world from falling apart even as his DEA Agent brother in law, Hank, finds numerous leads that could blaze a path straight to Walt.\_" poster_path: /r3z70vunihrAkjILQKWHX0G2xzO.jpg season_number: 5 vote_average: 8.9 spoken_languages: type: array items: type: object properties: english_name: type: string example: English iso_639_1: type: string example: en name: type: string example: English example: - english_name: English iso_639_1: en name: English - english_name: German iso_639_1: de name: Deutsch - english_name: Spanish iso_639_1: es name: Español status: type: string example: Ended tagline: type: string example: Change the equation. type: type: string example: Scripted vote_average: type: number example: 8.9 vote_count: type: number example: 14817 examples: Details: value: adult: false backdrop_path: /gc8PfyTqzqltKPW3X0cIVUGmagz.jpg created_by: - credit_id: 52542286760ee31328001a7b gender: 2 id: 66633 name: Vince Gilligan original_name: Vince Gilligan profile_path: /z3E0DhBg1V1PZVEtS9vfFPzOWYB.jpg episode_run_time: [] first_air_date: '2008-01-20' genres: - id: 18 name: Drama - id: 80 name: Crime homepage: https://www.sonypictures.com/tv/breakingbad id: 1396 in_production: false languages: - en - de - es last_air_date: '2013-09-29' last_episode_to_air: air_date: '2013-09-29' episode_number: 16 episode_type: finale id: 62161 name: Felina overview: All bad things must come to an end. production_code: '' runtime: 56 season_number: 5 show_id: 1396 still_path: /pA0YwyhvdDXP3BEGL2grrIhq8aM.jpg vote_average: 9.223 vote_count: 222 name: Breaking Bad networks: - id: 174 logo_path: /pmvRmATOCaDykE6JrVoeYxlFHw3.png name: AMC origin_country: US next_episode_to_air: null number_of_episodes: 62 number_of_seasons: 5 origin_country: - US original_language: en original_name: Breaking Bad overview: >- Walter White, a New Mexico chemistry teacher, is diagnosed with Stage III cancer and given a prognosis of only two years left to live. He becomes filled with a sense of fearlessness and an unrelenting desire to secure his family's financial future at any cost as he enters the dangerous world of drugs and crime. popularity: 842.173 poster_path: /ztkUQFLlC19CCMYHW9o1zWhJRNq.jpg production_companies: - id: 11073 logo_path: /aCbASRcI1MI7DXjPbSW9Fcv9uGR.png name: Sony Pictures Television origin_country: US - id: 33742 logo_path: null name: High Bridge Productions origin_country: US - id: 2605 logo_path: null name: Gran Via Productions origin_country: US production_countries: - iso_3166_1: US name: United States of America seasons: - air_date: '2009-02-17' episode_count: 9 id: 3577 name: Specials overview: '' poster_path: /40dT79mDEZwXkQiZNBgSaydQFDP.jpg season_number: 0 vote_average: 0 - air_date: '2008-01-20' episode_count: 7 id: 3572 name: Season 1 overview: >- High school chemistry teacher Walter White's life is suddenly transformed by a dire medical diagnosis. Street-savvy former student Jesse Pinkman "teaches" Walter a new trade. poster_path: /1BP4xYv9ZG4ZVHkL7ocOziBbSYH.jpg season_number: 1 vote_average: 8.3 - air_date: '2009-03-08' episode_count: 13 id: 3573 name: Season 2 overview: >- Walt must deal with the chain reaction of his choice, as he and Jesse face new and severe consequences. When danger and suspicion around Walt escalate, he is pushed to new levels of desperation. Just how much higher will the stakes rise? How far is Walt willing to go to ensure his family's security? Will his grand plan spiral out of control? poster_path: /e3oGYpoTUhOFK0BJfloru5ZmGV.jpg season_number: 2 vote_average: 8.4 - air_date: '2010-03-21' episode_count: 13 id: 3575 name: Season 3 overview: >- Walt continues to battle dueling identities: a desperate husband and father trying to provide for his family, and a newly appointed key player in the Albuquerque drug trade. As the danger around him escalates, Walt is now entrenched in the complex worlds of an angst-ridden family on the verge of dissolution, and the ruthless and unrelenting drug cartel. poster_path: /ffP8Q8ew048YofHRnFVM18B2fPG.jpg season_number: 3 vote_average: 8.4 - air_date: '2011-07-17' episode_count: 13 id: 3576 name: Season 4 overview: >- Walt and Jesse must cope with the fallout of their previous actions, both personally and professionally. Tension mounts as Walt faces a true standoff with his employer, Gus, with neither side willing or able to back down. Walt must also adjust to a new relationship with Skyler, whom while still reconciling her relationship with Walt, is committed to properly laundering Walt’s money and ensuring her sister Marie and an ailing Hank are financially stable. poster_path: /5ewrnKp4TboU4hTLT5cWO350mHj.jpg season_number: 4 vote_average: 8.5 - air_date: '2012-07-15' episode_count: 16 id: 3578 name: Season 5 overview: "Walt is faced with the prospect of moving on in a world without his enemy. As the pressure of a criminal life starts to build, Skyler struggles to keep Walt’s terrible secrets. Facing resistance from sometime adversary and former Fring lieutenant Mike, Walt tries to keep his world from falling apart even as his DEA Agent brother in law, Hank, finds numerous leads that could blaze a path straight to Walt.\_" poster_path: /r3z70vunihrAkjILQKWHX0G2xzO.jpg season_number: 5 vote_average: 8.9 spoken_languages: - english_name: English iso_639_1: en name: English - english_name: German iso_639_1: de name: Deutsch - english_name: Spanish iso_639_1: es name: Español status: Ended tagline: Change the equation. type: Scripted vote_average: 8.9 vote_count: 14817 ````