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

# Primary Translations

> Get a list of the officially supported translations on TMDB.

While it's technically possible to add a translation in any one of the languages we have added to TMDB (we don't restrict content), the ones listed in this method are the ones we also support for localizing the website with which means they are "primary" translations.

These are all specified as IETF tags to identify the languages we use on TMDB. There is one exception which is image languages. They are currently only designated by a ISO-639-1 tag. This is a planned upgrade for the future.

We're always open to adding more if you think one should be added. You can ask about getting a new primary translation added by posting on the forums.

One more thing to mention, these are the translations that map to our website translation project. You can view and contribute to that project here.



## OpenAPI

````yaml api-reference/openapi.json get /3/configuration/primary_translations
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/configuration/primary_translations:
    get:
      tags:
        - Configuration
      summary: Primary Translations
      description: >-
        Get a list of the officially supported translations on TMDB.


        While it's technically possible to add a translation in any one of the
        languages we have added to TMDB (we don't restrict content), the ones
        listed in this method are the ones we also support for localizing the
        website with which means they are "primary" translations.


        These are all specified as IETF tags to identify the languages we use on
        TMDB. There is one exception which is image languages. They are
        currently only designated by a ISO-639-1 tag. This is a planned upgrade
        for the future.


        We're always open to adding more if you think one should be added. You
        can ask about getting a new primary translation added by posting on the
        forums.


        One more thing to mention, these are the translations that map to our
        website translation project. You can view and contribute to that project
        here.
      operationId: primaryTranslations
      responses:
        '200':
          description: Translations
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=3354
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Sun, 05 Jan 2025 21:27:24 GMT
            ETag:
              schema:
                type: string
                example: W/"c6cdb30b4091b8cee580f9b1a4cf34d9"
            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 80ad73d9e8162f436b9f5199b04830b4.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: eJTkoPboaldJByOyJxcpIyT1r7sUS6whSFjapTaFEt-6D-9gCxeCKw==
            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: '20881'
            x-memc-expires:
              schema:
                type: string
                example: '3354'
            x-memc-key:
              schema:
                type: string
                example: 66cdd9d50e1d69747aa16fdf196f30a0
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
                  example: af-ZA
                example:
                  - af-ZA
                  - ar-AE
                  - ar-BH
                  - ar-EG
                  - ar-IQ
                  - ar-JO
                  - ar-LY
                  - ar-MA
                  - ar-QA
                  - ar-SA
                  - ar-TD
                  - ar-YE
                  - be-BY
                  - bg-BG
                  - bn-BD
                  - br-FR
                  - ca-AD
                  - ca-ES
                  - ch-GU
                  - cs-CZ
                  - cy-GB
                  - da-DK
                  - de-AT
                  - de-CH
                  - de-DE
                  - el-CY
                  - el-GR
                  - en-AG
                  - en-AU
                  - en-BB
                  - en-BZ
                  - en-CA
                  - en-CM
                  - en-GB
                  - en-GG
                  - en-GH
                  - en-GI
                  - en-GY
                  - en-IE
                  - en-JM
                  - en-KE
                  - en-LC
                  - en-MW
                  - en-NZ
                  - en-PG
                  - en-TC
                  - en-US
                  - en-ZM
                  - en-ZW
                  - eo-EO
                  - es-AR
                  - es-CL
                  - es-DO
                  - es-EC
                  - es-ES
                  - es-GQ
                  - es-GT
                  - es-HN
                  - es-MX
                  - es-NI
                  - es-PA
                  - es-PE
                  - es-PY
                  - es-SV
                  - es-UY
                  - et-EE
                  - eu-ES
                  - fa-IR
                  - fi-FI
                  - fr-BF
                  - fr-CA
                  - fr-CD
                  - fr-CI
                  - fr-FR
                  - fr-GF
                  - fr-GP
                  - fr-MC
                  - fr-ML
                  - fr-MU
                  - fr-PF
                  - ga-IE
                  - gd-GB
                  - gl-ES
                  - he-IL
                  - hi-IN
                  - hr-HR
                  - hu-HU
                  - id-ID
                  - it-IT
                  - it-VA
                  - ja-JP
                  - ka-GE
                  - kk-KZ
                  - kn-IN
                  - ko-KR
                  - ku-TR
                  - ky-KG
                  - lt-LT
                  - lv-LV
                  - ml-IN
                  - mr-IN
                  - ms-MY
                  - ms-SG
                  - nb-NO
                  - nl-BE
                  - nl-NL
                  - no-NO
                  - pa-IN
                  - pl-PL
                  - pt-AO
                  - pt-BR
                  - pt-MZ
                  - pt-PT
                  - ro-MD
                  - ro-RO
                  - ru-RU
                  - si-LK
                  - sk-SK
                  - sl-SI
                  - so-SO
                  - sq-AL
                  - sq-XK
                  - sr-ME
                  - sr-RS
                  - sv-SE
                  - sw-TZ
                  - ta-IN
                  - te-IN
                  - th-TH
                  - tl-PH
                  - tr-TR
                  - uk-UA
                  - ur-PK
                  - uz-UZ
                  - vi-VN
                  - zh-CN
                  - zh-HK
                  - zh-SG
                  - zh-TW
                  - zu-ZA
              examples:
                Translations:
                  value:
                    - af-ZA
                    - ar-AE
                    - ar-BH
                    - ar-EG
                    - ar-IQ
                    - ar-JO
                    - ar-LY
                    - ar-MA
                    - ar-QA
                    - ar-SA
                    - ar-TD
                    - ar-YE
                    - be-BY
                    - bg-BG
                    - bn-BD
                    - br-FR
                    - ca-AD
                    - ca-ES
                    - ch-GU
                    - cs-CZ
                    - cy-GB
                    - da-DK
                    - de-AT
                    - de-CH
                    - de-DE
                    - el-CY
                    - el-GR
                    - en-AG
                    - en-AU
                    - en-BB
                    - en-BZ
                    - en-CA
                    - en-CM
                    - en-GB
                    - en-GG
                    - en-GH
                    - en-GI
                    - en-GY
                    - en-IE
                    - en-JM
                    - en-KE
                    - en-LC
                    - en-MW
                    - en-NZ
                    - en-PG
                    - en-TC
                    - en-US
                    - en-ZM
                    - en-ZW
                    - eo-EO
                    - es-AR
                    - es-CL
                    - es-DO
                    - es-EC
                    - es-ES
                    - es-GQ
                    - es-GT
                    - es-HN
                    - es-MX
                    - es-NI
                    - es-PA
                    - es-PE
                    - es-PY
                    - es-SV
                    - es-UY
                    - et-EE
                    - eu-ES
                    - fa-IR
                    - fi-FI
                    - fr-BF
                    - fr-CA
                    - fr-CD
                    - fr-CI
                    - fr-FR
                    - fr-GF
                    - fr-GP
                    - fr-MC
                    - fr-ML
                    - fr-MU
                    - fr-PF
                    - ga-IE
                    - gd-GB
                    - gl-ES
                    - he-IL
                    - hi-IN
                    - hr-HR
                    - hu-HU
                    - id-ID
                    - it-IT
                    - it-VA
                    - ja-JP
                    - ka-GE
                    - kk-KZ
                    - kn-IN
                    - ko-KR
                    - ku-TR
                    - ky-KG
                    - lt-LT
                    - lv-LV
                    - ml-IN
                    - mr-IN
                    - ms-MY
                    - ms-SG
                    - nb-NO
                    - nl-BE
                    - nl-NL
                    - no-NO
                    - pa-IN
                    - pl-PL
                    - pt-AO
                    - pt-BR
                    - pt-MZ
                    - pt-PT
                    - ro-MD
                    - ro-RO
                    - ru-RU
                    - si-LK
                    - sk-SK
                    - sl-SI
                    - so-SO
                    - sq-AL
                    - sq-XK
                    - sr-ME
                    - sr-RS
                    - sv-SE
                    - sw-TZ
                    - ta-IN
                    - te-IN
                    - th-TH
                    - tl-PH
                    - tr-TR
                    - uk-UA
                    - ur-PK
                    - uz-UZ
                    - vi-VN
                    - zh-CN
                    - zh-HK
                    - zh-SG
                    - zh-TW
                    - zu-ZA

````