> ## 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 > Query the details of a TV episode. This method supports using append_to_response. Read more about this here. ## OpenAPI ````yaml api-reference/openapi.json get /3/tv/{{series_id}}/season/{{season_number}}/episode/{{episode_number}} 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}}/season/{{season_number}}/episode/{{episode_number}}: parameters: - name: series_id in: path required: true schema: type: string - name: season_number in: path required: true schema: type: string - name: episode_number in: path required: true schema: type: string get: tags: - TV Episodes summary: Details description: >- Query the details of a TV episode. This method supports using append_to_response. Read more about this here. operationId: details12 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=20028 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Sat, 11 Jan 2025 16:34:13 GMT ETag: schema: type: string example: W/"a23d3563d3b26d7810cc779320af406b" 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 58323cef7927326b4721718ec24b0aae.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: _cDUDTaUlAjY5pYVmMjAGTrAILqvGMFkmMLhAbC_cvTWqmEVsYEsnA== 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: '7645' x-memc-expires: schema: type: string example: '20028' x-memc-key: schema: type: string example: cdca940726031093dced24b54e41daa8 content: application/json: schema: type: object properties: air_date: type: string example: '2012-09-02' crew: type: array items: type: object properties: adult: type: boolean example: false credit_id: type: string example: 52542280760ee31328001325 department: type: string example: Directing gender: type: number example: 1 id: type: number example: 29779 job: type: string example: Director known_for_department: type: string example: Directing name: type: string example: Michelle MacLaren original_name: type: string example: Michelle MacLaren popularity: type: number example: 12.156 profile_path: type: string nullable: true example: /3LcH5eNiysMWaepARllVrS4Dzn7.jpg example: - adult: false credit_id: 52542280760ee31328001325 department: Directing gender: 1 id: 29779 job: Director known_for_department: Directing name: Michelle MacLaren original_name: Michelle MacLaren popularity: 12.156 profile_path: /3LcH5eNiysMWaepARllVrS4Dzn7.jpg - adult: false credit_id: 643fec9bb0ba7e04cf13314a department: Art gender: 1 id: 1537678 job: Assistant Art Director known_for_department: Art name: Paula Dal Santo original_name: Paula Dal Santo popularity: 0.337 profile_path: null - adult: false credit_id: 64603ebedbbb42015305d0a9 department: Camera gender: 2 id: 52034 job: Director of Photography known_for_department: Directing name: Michael Slovis original_name: Michael Slovis popularity: 9.012 profile_path: /6L2U9eY6YisJlxlmQEwims8Gkf3.jpg - adult: false credit_id: 6443b454651fcf04b29d2b4f department: Writing gender: 1 id: 1223198 job: Writer known_for_department: Writing name: Moira Walley-Beckett original_name: Moira Walley-Beckett popularity: 7.899 profile_path: /1sRNcxMZVsVcY6NFNQzASJuR8By.jpg episode_number: type: number example: 8 guest_stars: type: array items: type: object properties: adult: type: boolean example: false character: type: string example: Steven Gomez credit_id: type: string example: 5271b489760ee35b3e0881a7 gender: type: number example: 2 id: type: number example: 61535 known_for_department: type: string example: Acting name: type: string example: Steven Michael Quezada order: type: number example: 8 original_name: type: string example: Steven Michael Quezada popularity: type: number example: 4.523 profile_path: type: string nullable: true example: /pVYrDkwI6GWvCNL2kJhpDJfBFyd.jpg example: - adult: false character: Steven Gomez credit_id: 5271b489760ee35b3e0881a7 gender: 2 id: 61535 known_for_department: Acting name: Steven Michael Quezada order: 8 original_name: Steven Michael Quezada popularity: 4.523 profile_path: /pVYrDkwI6GWvCNL2kJhpDJfBFyd.jpg - adult: false character: Dennis Markowski credit_id: 5276f379760ee34f980c1dff gender: 2 id: 109687 known_for_department: Acting name: Mike Batayeh order: 619 original_name: Mike Batayeh popularity: 10.241 profile_path: /9uMJaSYCHjwRaXIe7ajpvDeURVC.jpg - adult: false character: Dan Wachsberger credit_id: 5277f141760ee36033476505 gender: 2 id: 2128853 known_for_department: Production name: Chris Freihofer order: 620 original_name: Chris Freihofer popularity: 12.637 profile_path: /2hrz73LkQoTFCa7jZJMJUj5S5oc.jpg - adult: false character: Asst. US Attorney credit_id: 5278121c760ee36b951e53f1 gender: 2 id: 197857 known_for_department: Acting name: Craig Nigh order: 621 original_name: Craig Nigh popularity: 10.634 profile_path: /6dUivUU1OEmixR7ettlonsL5KDX.jpg - adult: false character: Declan's Driver credit_id: 5277fe8e760ee331ce03390f gender: 0 id: 223395 known_for_department: Acting name: Morse Bicknell order: 627 original_name: Morse Bicknell popularity: 4.215 profile_path: /14z7m7PpgLpNWN5EShCmKmm12zb.jpg - adult: false character: Uncle Jack credit_id: 52780156760ee3397038de79 gender: 2 id: 2234 known_for_department: Acting name: Michael Bowen order: 660 original_name: Michael Bowen popularity: 18.577 profile_path: /8clG1Q984hsYJSfpOVbnoJAEJb2.jpg - adult: false character: Kenny credit_id: 527801a9760ee331ce03af8a gender: 2 id: 114000 known_for_department: Acting name: Kevin Rankin order: 661 original_name: Kevin Rankin popularity: 26.712 profile_path: /fOW5R6BSgRvMrt2R7KAxSk7L4H2.jpg - adult: false character: Frankie credit_id: 527811bc760ee35e8e226e09 gender: 2 id: 1268114 known_for_department: Acting name: Patrick Sane order: 663 original_name: Patrick Sane popularity: 6.086 profile_path: /AnT9tInB0UNpZszdUiT5wT1AzpI.jpg - adult: false character: Lydia Rodarte-Quayle credit_id: 6524ad8ed399e6011d14adb3 gender: 1 id: 42279 known_for_department: Acting name: Laura Fraser order: 724 original_name: Laura Fraser popularity: 32.132 profile_path: /4aD3xDLA22CIf6jdK0IAs75h8pp.jpg - adult: false character: Todd credit_id: 6524ae29447f9c010048439b gender: 2 id: 88124 known_for_department: Acting name: Jesse Plemons order: 725 original_name: Jesse Plemons popularity: 40.903 profile_path: /ckTthGclQE0y6b7gR0RpRo7LskL.jpg - adult: false character: Ron Forenall credit_id: 653eb5b4c8a5ac011d6d9ef9 gender: 0 id: 1808731 known_for_department: Acting name: Russ Dillen order: 826 original_name: Russ Dillen popularity: 2.334 profile_path: /iVDlokqyhNPuoEC0pGtEq0BI9i2.jpg - adult: false character: TV Reporter credit_id: 653eb6f030813100ae619803 gender: 1 id: 1797280 known_for_department: Acting name: Antoinette Antonio order: 829 original_name: Antoinette Antonio popularity: 1.144 profile_path: /tzyXZlK7iF89Cnm1xsUOWioK3N0.jpg - adult: false character: Public Defender credit_id: 659dad671d35630095d6aa8c gender: 0 id: 4472830 known_for_department: Acting name: Scott Ward order: 851 original_name: Scott Ward popularity: 0.001 profile_path: null id: type: number example: 62154 name: type: string example: Gliding Over All overview: type: string example: >- Walt takes care of loose ends; Walt makes a dangerous decision. production_code: type: string example: '' runtime: type: number example: 48 season_number: type: number example: 5 still_path: type: string example: /uTAPBgAah14jQbV98Sw7iqJD4W7.jpg vote_average: type: number example: 9.102 vote_count: type: number example: 142 examples: Details: value: air_date: '2012-09-02' crew: - adult: false credit_id: 52542280760ee31328001325 department: Directing gender: 1 id: 29779 job: Director known_for_department: Directing name: Michelle MacLaren original_name: Michelle MacLaren popularity: 12.156 profile_path: /3LcH5eNiysMWaepARllVrS4Dzn7.jpg - adult: false credit_id: 643fec9bb0ba7e04cf13314a department: Art gender: 1 id: 1537678 job: Assistant Art Director known_for_department: Art name: Paula Dal Santo original_name: Paula Dal Santo popularity: 0.337 profile_path: null - adult: false credit_id: 64603ebedbbb42015305d0a9 department: Camera gender: 2 id: 52034 job: Director of Photography known_for_department: Directing name: Michael Slovis original_name: Michael Slovis popularity: 9.012 profile_path: /6L2U9eY6YisJlxlmQEwims8Gkf3.jpg - adult: false credit_id: 6443b454651fcf04b29d2b4f department: Writing gender: 1 id: 1223198 job: Writer known_for_department: Writing name: Moira Walley-Beckett original_name: Moira Walley-Beckett popularity: 7.899 profile_path: /1sRNcxMZVsVcY6NFNQzASJuR8By.jpg episode_number: 8 guest_stars: - adult: false character: Steven Gomez credit_id: 5271b489760ee35b3e0881a7 gender: 2 id: 61535 known_for_department: Acting name: Steven Michael Quezada order: 8 original_name: Steven Michael Quezada popularity: 4.523 profile_path: /pVYrDkwI6GWvCNL2kJhpDJfBFyd.jpg - adult: false character: Dennis Markowski credit_id: 5276f379760ee34f980c1dff gender: 2 id: 109687 known_for_department: Acting name: Mike Batayeh order: 619 original_name: Mike Batayeh popularity: 10.241 profile_path: /9uMJaSYCHjwRaXIe7ajpvDeURVC.jpg - adult: false character: Dan Wachsberger credit_id: 5277f141760ee36033476505 gender: 2 id: 2128853 known_for_department: Production name: Chris Freihofer order: 620 original_name: Chris Freihofer popularity: 12.637 profile_path: /2hrz73LkQoTFCa7jZJMJUj5S5oc.jpg - adult: false character: Asst. US Attorney credit_id: 5278121c760ee36b951e53f1 gender: 2 id: 197857 known_for_department: Acting name: Craig Nigh order: 621 original_name: Craig Nigh popularity: 10.634 profile_path: /6dUivUU1OEmixR7ettlonsL5KDX.jpg - adult: false character: Declan's Driver credit_id: 5277fe8e760ee331ce03390f gender: 0 id: 223395 known_for_department: Acting name: Morse Bicknell order: 627 original_name: Morse Bicknell popularity: 4.215 profile_path: /14z7m7PpgLpNWN5EShCmKmm12zb.jpg - adult: false character: Uncle Jack credit_id: 52780156760ee3397038de79 gender: 2 id: 2234 known_for_department: Acting name: Michael Bowen order: 660 original_name: Michael Bowen popularity: 18.577 profile_path: /8clG1Q984hsYJSfpOVbnoJAEJb2.jpg - adult: false character: Kenny credit_id: 527801a9760ee331ce03af8a gender: 2 id: 114000 known_for_department: Acting name: Kevin Rankin order: 661 original_name: Kevin Rankin popularity: 26.712 profile_path: /fOW5R6BSgRvMrt2R7KAxSk7L4H2.jpg - adult: false character: Frankie credit_id: 527811bc760ee35e8e226e09 gender: 2 id: 1268114 known_for_department: Acting name: Patrick Sane order: 663 original_name: Patrick Sane popularity: 6.086 profile_path: /AnT9tInB0UNpZszdUiT5wT1AzpI.jpg - adult: false character: Lydia Rodarte-Quayle credit_id: 6524ad8ed399e6011d14adb3 gender: 1 id: 42279 known_for_department: Acting name: Laura Fraser order: 724 original_name: Laura Fraser popularity: 32.132 profile_path: /4aD3xDLA22CIf6jdK0IAs75h8pp.jpg - adult: false character: Todd credit_id: 6524ae29447f9c010048439b gender: 2 id: 88124 known_for_department: Acting name: Jesse Plemons order: 725 original_name: Jesse Plemons popularity: 40.903 profile_path: /ckTthGclQE0y6b7gR0RpRo7LskL.jpg - adult: false character: Ron Forenall credit_id: 653eb5b4c8a5ac011d6d9ef9 gender: 0 id: 1808731 known_for_department: Acting name: Russ Dillen order: 826 original_name: Russ Dillen popularity: 2.334 profile_path: /iVDlokqyhNPuoEC0pGtEq0BI9i2.jpg - adult: false character: TV Reporter credit_id: 653eb6f030813100ae619803 gender: 1 id: 1797280 known_for_department: Acting name: Antoinette Antonio order: 829 original_name: Antoinette Antonio popularity: 1.144 profile_path: /tzyXZlK7iF89Cnm1xsUOWioK3N0.jpg - adult: false character: Public Defender credit_id: 659dad671d35630095d6aa8c gender: 0 id: 4472830 known_for_department: Acting name: Scott Ward order: 851 original_name: Scott Ward popularity: 0.001 profile_path: null id: 62154 name: Gliding Over All overview: >- Walt takes care of loose ends; Walt makes a dangerous decision. production_code: '' runtime: 48 season_number: 5 still_path: /uTAPBgAah14jQbV98Sw7iqJD4W7.jpg vote_average: 9.102 vote_count: 142 ````