> ## 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 season. 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}} 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}}: parameters: - name: series_id in: path required: true schema: type: string - name: season_number in: path required: true schema: type: string get: tags: - TV Seasons summary: Details description: >- Query the details of a TV season. This method supports using `append_to_response`. Read more about this here. operationId: details11 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=3579 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Sat, 11 Jan 2025 16:11:14 GMT ETag: schema: type: string example: W/"f15233d2975ff783ba6f2bd4a33f3655" 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 29a90787d8a9611938ee5f68e42b9f66.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: fijDUKxOfvwmesVLLhQNBY5l4rQpSRZBZ477cNNogzxOn-hnn7zADw== 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: '22766' x-memc-expires: schema: type: string example: '3579' x-memc-key: schema: type: string example: b63bb77be34a5e0c3232933c3c91a524 content: application/json: schema: type: object properties: _id: type: string example: 677c1c5582cce15a76752821 air_date: type: string example: '2025-01-06' episodes: type: array items: type: object properties: air_date: type: string example: '2025-01-06' crew: type: array items: {} example: [] episode_number: type: number example: 1 episode_type: type: string example: standard guest_stars: type: array items: type: object properties: adult: type: boolean example: false character: type: string example: Cartographer Chase credit_id: type: string example: 66833c9c9cd9bceb3b21fa72 gender: type: number example: 2 id: type: number example: 3103914 known_for_department: type: string example: Acting name: type: string example: Chase Hilt order: type: number example: 657 original_name: type: string example: Chase Hilt popularity: type: number example: 6.75 profile_path: type: string example: /nTB14wzCjDIzbxS9r3gTrVBrDFY.jpg example: - adult: false character: Cartographer Chase credit_id: 66833c9c9cd9bceb3b21fa72 gender: 2 id: 3103914 known_for_department: Acting name: Chase Hilt order: 657 original_name: Chase Hilt popularity: 6.75 profile_path: /nTB14wzCjDIzbxS9r3gTrVBrDFY.jpg - adult: false character: Self credit_id: 677c77397c9e80b9e8723aed gender: 2 id: 94357 known_for_department: Acting name: Keith Urban order: 711 original_name: Keith Urban popularity: 14.894 profile_path: /6jB3gPO4yhdr24iqLjNS1Nw83SL.jpg id: type: number example: 5881256 name: type: string example: International New Years Foods Taste Test overview: type: string example: >- Today, we're trying new years dishes from around the world! GMM # 2733 production_code: type: string example: '' runtime: type: number example: 28 season_number: type: number example: 27 show_id: type: number example: 65701 still_path: type: string example: /kvhSDGQMVmRruwJ1B5452boYo3H.jpg vote_average: type: number example: 0 vote_count: type: number example: 0 example: - air_date: '2025-01-06' crew: [] episode_number: 1 episode_type: standard guest_stars: - adult: false character: Cartographer Chase credit_id: 66833c9c9cd9bceb3b21fa72 gender: 2 id: 3103914 known_for_department: Acting name: Chase Hilt order: 657 original_name: Chase Hilt popularity: 6.75 profile_path: /nTB14wzCjDIzbxS9r3gTrVBrDFY.jpg - adult: false character: Self credit_id: 677c77397c9e80b9e8723aed gender: 2 id: 94357 known_for_department: Acting name: Keith Urban order: 711 original_name: Keith Urban popularity: 14.894 profile_path: /6jB3gPO4yhdr24iqLjNS1Nw83SL.jpg id: 5881256 name: International New Years Foods Taste Test overview: >- Today, we're trying new years dishes from around the world! GMM # 2733 production_code: '' runtime: 28 season_number: 27 show_id: 65701 still_path: /kvhSDGQMVmRruwJ1B5452boYo3H.jpg vote_average: 0 vote_count: 0 - air_date: '2025-01-07' crew: [] episode_number: 2 episode_type: standard guest_stars: - adult: false character: Chase The Rage Hilt credit_id: 677d1f3355d4b38f93675612 gender: 2 id: 3103914 known_for_department: Acting name: Chase Hilt order: 712 original_name: Chase Hilt popularity: 6.75 profile_path: /nTB14wzCjDIzbxS9r3gTrVBrDFY.jpg id: 5883259 name: Dollar Tree Vs. Expensive Product Test overview: >- Are these Dollar Tree products as good as the rest? GMM # 2733 production_code: '' runtime: 24 season_number: 27 show_id: 65701 still_path: /pgkXAP8JW617K07fKjl21aDLoNz.jpg vote_average: 0 vote_count: 0 - air_date: '2025-01-08' crew: [] episode_number: 3 episode_type: standard guest_stars: [] id: 5886402 name: Most Expensive Fast Food Items (Taste Test) overview: >- Which of these expensive fast food items are actually worth it? GMM # 2735 production_code: '' runtime: 19 season_number: 27 show_id: 65701 still_path: /3pe007DA2OdsH8kfdeHgBxxt81C.jpg vote_average: 0 vote_count: 0 - air_date: '2025-01-09' crew: [] episode_number: 4 episode_type: standard guest_stars: [] id: 5888548 name: Testing Amazon's Weirdest Products overview: 'Today, we''re buying weird stuff off Amazon GMM # 2736' production_code: '' runtime: 20 season_number: 27 show_id: 65701 still_path: /bjFAGMOxmKugdWqavT61gQd8TeA.jpg vote_average: 0 vote_count: 0 - air_date: '2025-01-10' crew: [] episode_number: 5 episode_type: standard guest_stars: [] id: 5890389 name: 2025 Food Trends Taste Test overview: >- Today, we're judging some new food trend predictions for 2025 GMM # 2737 production_code: '' runtime: 20 season_number: 27 show_id: 65701 still_path: /qFPPb2i6MVLAIWICAsOymmVNk09.jpg vote_average: 0 vote_count: 0 id: type: number example: 436570 name: type: string example: Season 27 overview: type: string example: '' poster_path: nullable: true example: null season_number: type: number example: 27 vote_average: type: number example: 0 examples: Details: value: _id: 677c1c5582cce15a76752821 air_date: '2025-01-06' episodes: - air_date: '2025-01-06' crew: [] episode_number: 1 episode_type: standard guest_stars: - adult: false character: Cartographer Chase credit_id: 66833c9c9cd9bceb3b21fa72 gender: 2 id: 3103914 known_for_department: Acting name: Chase Hilt order: 657 original_name: Chase Hilt popularity: 6.75 profile_path: /nTB14wzCjDIzbxS9r3gTrVBrDFY.jpg - adult: false character: Self credit_id: 677c77397c9e80b9e8723aed gender: 2 id: 94357 known_for_department: Acting name: Keith Urban order: 711 original_name: Keith Urban popularity: 14.894 profile_path: /6jB3gPO4yhdr24iqLjNS1Nw83SL.jpg id: 5881256 name: International New Years Foods Taste Test overview: >- Today, we're trying new years dishes from around the world! GMM # 2733 production_code: '' runtime: 28 season_number: 27 show_id: 65701 still_path: /kvhSDGQMVmRruwJ1B5452boYo3H.jpg vote_average: 0 vote_count: 0 - air_date: '2025-01-07' crew: [] episode_number: 2 episode_type: standard guest_stars: - adult: false character: Chase The Rage Hilt credit_id: 677d1f3355d4b38f93675612 gender: 2 id: 3103914 known_for_department: Acting name: Chase Hilt order: 712 original_name: Chase Hilt popularity: 6.75 profile_path: /nTB14wzCjDIzbxS9r3gTrVBrDFY.jpg id: 5883259 name: Dollar Tree Vs. Expensive Product Test overview: >- Are these Dollar Tree products as good as the rest? GMM # 2733 production_code: '' runtime: 24 season_number: 27 show_id: 65701 still_path: /pgkXAP8JW617K07fKjl21aDLoNz.jpg vote_average: 0 vote_count: 0 - air_date: '2025-01-08' crew: [] episode_number: 3 episode_type: standard guest_stars: [] id: 5886402 name: Most Expensive Fast Food Items (Taste Test) overview: >- Which of these expensive fast food items are actually worth it? GMM # 2735 production_code: '' runtime: 19 season_number: 27 show_id: 65701 still_path: /3pe007DA2OdsH8kfdeHgBxxt81C.jpg vote_average: 0 vote_count: 0 - air_date: '2025-01-09' crew: [] episode_number: 4 episode_type: standard guest_stars: [] id: 5888548 name: Testing Amazon's Weirdest Products overview: 'Today, we''re buying weird stuff off Amazon GMM # 2736' production_code: '' runtime: 20 season_number: 27 show_id: 65701 still_path: /bjFAGMOxmKugdWqavT61gQd8TeA.jpg vote_average: 0 vote_count: 0 - air_date: '2025-01-10' crew: [] episode_number: 5 episode_type: standard guest_stars: [] id: 5890389 name: 2025 Food Trends Taste Test overview: >- Today, we're judging some new food trend predictions for 2025 GMM # 2737 production_code: '' runtime: 20 season_number: 27 show_id: 65701 still_path: /qFPPb2i6MVLAIWICAsOymmVNk09.jpg vote_average: 0 vote_count: 0 id: 436570 name: Season 27 overview: '' poster_path: null season_number: 27 vote_average: 0 ````