> ## 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.

# Images

> Get the images that belong to a TV episode.

This method will return the backdrops that have been added to a TV episode.

**📘Note**

If you have a language specified, it will act as a filter on the returned items. You can use the include_image_language param to query additional languages.



## OpenAPI

````yaml api-reference/openapi.json get /3/tv/{{series_id}}/season/{{season_number}}/episode/{{episode_number}}/images
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}}/images:
    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: Images
      description: >-
        Get the images that belong to a TV episode.


        This method will return the backdrops that have been added to a TV
        episode.


        **📘Note**


        If you have a language specified, it will act as a filter on the
        returned items. You can use the include_image_language param to query
        additional languages.
      operationId: images7
      responses:
        '200':
          description: Images
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=10142
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Sun, 12 Jan 2025 11:56:07 GMT
            ETag:
              schema:
                type: string
                example: W/"d99ba6978c2247c0cb4600aa9ceb2754"
            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 552902bab7d1a219a13b7843f4afebae.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: O7jbfyJ66O8Hle8sgnJMPX7WMLNKIzI2GIt2PfkCE8__Nzr1xmzj4Q==
            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: '14063'
            x-memc-expires:
              schema:
                type: string
                example: '10142'
            x-memc-key:
              schema:
                type: string
                example: caa236af6fb3714e08a8a739218d8bb5
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: number
                    example: 62148
                  stills:
                    type: array
                    items:
                      type: object
                      properties:
                        aspect_ratio:
                          type: number
                          example: 1.778
                        file_path:
                          type: string
                          example: /gf7ipzUCJq20Oxrt3aOafUrjgFU.jpg
                        height:
                          type: number
                          example: 1080
                        iso_639_1:
                          nullable: true
                          example: null
                        vote_average:
                          type: number
                          example: 8.034
                        vote_count:
                          type: number
                          example: 5
                        width:
                          type: number
                          example: 1920
                    example:
                      - aspect_ratio: 1.778
                        file_path: /gf7ipzUCJq20Oxrt3aOafUrjgFU.jpg
                        height: 1080
                        iso_639_1: null
                        vote_average: 8.034
                        vote_count: 5
                        width: 1920
                      - aspect_ratio: 1.778
                        file_path: /9WIzJqqUthdASBRE1Ts8ymrDhIv.jpg
                        height: 1080
                        iso_639_1: null
                        vote_average: 7.542
                        vote_count: 8
                        width: 1920
              examples:
                Images:
                  value:
                    id: 62148
                    stills:
                      - aspect_ratio: 1.778
                        file_path: /gf7ipzUCJq20Oxrt3aOafUrjgFU.jpg
                        height: 1080
                        iso_639_1: null
                        vote_average: 8.034
                        vote_count: 5
                        width: 1920
                      - aspect_ratio: 1.778
                        file_path: /9WIzJqqUthdASBRE1Ts8ymrDhIv.jpg
                        height: 1080
                        iso_639_1: null
                        vote_average: 7.542
                        vote_count: 8
                        width: 1920

````