> ## 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 profile images that belong to a person.

This method will return the profile images that have been added to a person.



## OpenAPI

````yaml api-reference/openapi.json get /3/person/{{person_id}}/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/person/{{person_id}}/images:
    parameters:
      - name: person_id
        in: path
        required: true
        schema:
          type: string
    get:
      tags:
        - People
      summary: Images
      description: >-
        Get the profile images that belong to a person.


        This method will return the profile images that have been added to a
        person.
      operationId: images4
      responses:
        '200':
          description: Images
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=19274
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Fri, 10 Jan 2025 02:01:35 GMT
            ETag:
              schema:
                type: string
                example: W/"ebc5f86090adc4ca53d4811036e910d2"
            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 2753b41455655294f3c924b22dffed5e.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: n0YiY7diY4AICYS8ryPdGeEeQdbMDvwPxSyOpvXB9u2qQXvn-unkdg==
            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: '7393'
            x-memc-expires:
              schema:
                type: string
                example: '19274'
            x-memc-key:
              schema:
                type: string
                example: 307eb82beeeff2b452722469074a1823
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: number
                    example: 63429
                  profiles:
                    type: array
                    items:
                      type: object
                      properties:
                        aspect_ratio:
                          type: number
                          example: 0.667
                        file_path:
                          type: string
                          example: /oTpZ0Ek4qoI8U0tRIViUhgfB05b.jpg
                        height:
                          type: number
                          example: 750
                        iso_639_1:
                          nullable: true
                          example: null
                        vote_average:
                          type: number
                          example: 3.334
                        vote_count:
                          type: number
                          example: 1
                        width:
                          type: number
                          example: 500
                    example:
                      - aspect_ratio: 0.667
                        file_path: /oTpZ0Ek4qoI8U0tRIViUhgfB05b.jpg
                        height: 750
                        iso_639_1: null
                        vote_average: 3.334
                        vote_count: 1
                        width: 500
                      - aspect_ratio: 0.667
                        file_path: /7BiDLC1xZ44VbyDLELpaNkmsp3Z.jpg
                        height: 660
                        iso_639_1: null
                        vote_average: 3.334
                        vote_count: 3
                        width: 440
                      - aspect_ratio: 0.667
                        file_path: /p2km6QNG7S2Epp9ljfbEUyYugV1.jpg
                        height: 960
                        iso_639_1: null
                        vote_average: 2.542
                        vote_count: 4
                        width: 640
                      - aspect_ratio: 0.667
                        file_path: /bKp9Yozr7jir6xThbagixx2pyy7.jpg
                        height: 900
                        iso_639_1: null
                        vote_average: 0.958
                        vote_count: 4
                        width: 600
                      - aspect_ratio: 0.667
                        file_path: /tz0l89HtOfXxRJnBvJ8hfBmQ9yc.jpg
                        height: 600
                        iso_639_1: null
                        vote_average: 0.958
                        vote_count: 4
                        width: 400
                      - aspect_ratio: 0.667
                        file_path: /8hJHvwdhKvOfzW6Vo5S2W6Qy8mE.jpg
                        height: 946
                        iso_639_1: null
                        vote_average: 0.166
                        vote_count: 1
                        width: 631
              examples:
                Images:
                  value:
                    id: 63429
                    profiles:
                      - aspect_ratio: 0.667
                        file_path: /oTpZ0Ek4qoI8U0tRIViUhgfB05b.jpg
                        height: 750
                        iso_639_1: null
                        vote_average: 3.334
                        vote_count: 1
                        width: 500
                      - aspect_ratio: 0.667
                        file_path: /7BiDLC1xZ44VbyDLELpaNkmsp3Z.jpg
                        height: 660
                        iso_639_1: null
                        vote_average: 3.334
                        vote_count: 3
                        width: 440
                      - aspect_ratio: 0.667
                        file_path: /p2km6QNG7S2Epp9ljfbEUyYugV1.jpg
                        height: 960
                        iso_639_1: null
                        vote_average: 2.542
                        vote_count: 4
                        width: 640
                      - aspect_ratio: 0.667
                        file_path: /bKp9Yozr7jir6xThbagixx2pyy7.jpg
                        height: 900
                        iso_639_1: null
                        vote_average: 0.958
                        vote_count: 4
                        width: 600
                      - aspect_ratio: 0.667
                        file_path: /tz0l89HtOfXxRJnBvJ8hfBmQ9yc.jpg
                        height: 600
                        iso_639_1: null
                        vote_average: 0.958
                        vote_count: 4
                        width: 400
                      - aspect_ratio: 0.667
                        file_path: /8hJHvwdhKvOfzW6Vo5S2W6Qy8mE.jpg
                        height: 946
                        iso_639_1: null
                        vote_average: 0.166
                        vote_count: 1
                        width: 631

````