Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Translate
  • Getting started
    • All guides
    • How to translate text
    • How to improve the accuracy of translations
    • Detecting language
    • Getting a list of supported languages
    • Setting up access with API keys
  • Access management
  • Pricing policy

In this article:

  • Getting started
  • Get the list of supported languages
  1. Step-by-step guides
  2. Getting a list of supported languages

Getting a list of supported languages

Written by
Yandex Cloud
Updated at April 21, 2025
  • Getting started
  • Get the list of supported languages

Getting startedGetting started

To use the examples, install cURL.

To authenticate under a service account, you can use an API key or an IAM token; to authenticate under a user account, you can only use an IAM token.

Get your account details for authentication in the Translate API:

API key
IAM token
  1. If you do not have a service account, create one.

  2. Assign the ai.translate.user role for the folder to the service account.

  3. Get the ID of the folder your service account was created in. Make sure to include the folder ID in the folderId field in the body of each request.

  4. Create an API key with the yc.ai.translate.execute scope.

    Provide the key in the Authorization header of each request in the following format:

    Authorization: Api-Key <API_key>
    
  1. Get the ID of any folder for which your account has the ai.translate.user role or higher. Make sure to include the folder ID in the folderId field in the body of each request.

  2. Get an IAM token for your Yandex account, federated account or service account.

    Provide the token in the Authorization header of each request in the following format:

    Authorization: Bearer <IAM_token>
    

The example below is intended to be run in MacOS and Linux. To run it in Windows, see how to work with Bash in Microsoft Windows.

Get the list of supported languagesGet the list of supported languages

Get the list of supported languages using the listLanguages method:

cURL
export FOLDER_ID=<folder_ID>
export API_KEY=<API_key>
curl \
  --request POST \
  --header "Content-Type: application/json" \
  --header "Authorization: Api-Key ${API_KEY}" \
  --data "{\"folderId\": \"${FOLDER_ID}\"}" \
  "https://translate.api.cloud.yandex.net/translate/v2/languages"

Where:

  • FOLDER_ID: Folder ID you got before you started.
  • Where API_KEY is the API key you got before you started. If you use an IAM token for authentication, change the Authorization header to "Authorization: Bearer <IAM_token>".

The response will contain a list of language names in the corresponding language:

{
    "languages": [
        {
        "code": "az",
        "name": "azərbaycan"
        },
        {
        "code": "sq",
        "name": "shqip"
        },
        {
        "code": "am",
        "name": "አማርኛ"
        },
        {
        "code": "en",
        "name": "English"
        },
        ...
    ]
}

Was the article helpful?

Previous
Detecting language
Next
Setting up access with API keys
Yandex project
© 2025 Yandex.Cloud LLC