Localization: language parameter and supported locales

Most Astra API endpoints return localized text fields such as displayName and description. By default, these fields are returned in English (US). You can request a different locale by adding a language query parameter to any supported endpoint, making it straightforward to build apps for audiences around the world.

Using the language parameter

Append ?language=<locale> to any supported endpoint. For example, to fetch agent data in Japanese:

curl "https://astra.teamfortuna.xyz/v1/agents?language=ja-JP" \
  -H "User-Agent: my-app/1.0.0 (+https://example.com)"

Supported locales

Locale code	Language / Region
`ar-AE`	Arabic (UAE)
`de-DE`	German (Germany)
`en-US`	English (US) — default
`es-ES`	Spanish (Spain)
`es-MX`	Spanish (Mexico)
`fr-FR`	French (France)
`id-ID`	Indonesian (Indonesia)
`it-IT`	Italian (Italy)
`ja-JP`	Japanese (Japan)
`ko-KR`	Korean (Korea)
`pl-PL`	Polish (Poland)
`pt-BR`	Portuguese (Brazil)
`ru-RU`	Russian (Russia)
`th-TH`	Thai (Thailand)
`tr-TR`	Turkish (Turkey)
`vi-VN`	Vietnamese (Vietnam)
`zh-CN`	Chinese Simplified (China)
`zh-TW`	Chinese Traditional (Taiwan)

Fetching all locales at once

Pass ?language=all to receive data for every supported locale in a single response. When you use this option, string fields like displayName and description are returned as objects keyed by locale code instead of plain strings.

curl "https://astra.teamfortuna.xyz/v1/agents?language=all" \
  -H "User-Agent: my-app/1.0.0 (+https://example.com)"

Example response with ?language=all:

{
  "status": 200,
  "data": [
    {
      "uuid": "e370fa57-4757-3604-3648-499e1f642d3f",
      "displayName": {
        "ar-AE": "بريمو",
        "de-DE": "Primo",
        "en-US": "Primo",
        "es-ES": "Primo",
        "ja-JP": "プリモ",
        "ko-KR": "프리모",
        "zh-CN": "普里莫",
        "zh-TW": "普里莫"
      },
      "description": {
        "en-US": "A duelist who manipulates earth and granite...",
        "ja-JP": "地球と花崗岩を操るデュエリスト..."
      }
    }
  ]
}

When the language parameter is omitted, the API returns en-US by default.

Localization string tables

Raw locale string data for all in-game text is available via the /v1/locres endpoint. This is useful if you need low-level access to the game’s full localization tables rather than per-asset translations. See the locres API reference for details.

Get Started

Concepts

Localization: language parameter and supported locales

Using the language parameter

Supported locales

Fetching all locales at once

Localization string tables

​Using the language parameter

​Supported locales

​Fetching all locales at once

​Localization string tables

Using the language parameter

Supported locales

Fetching all locales at once

Localization string tables