---
title: "GET /v1/translations"
method: GET
path: "/v1/translations"
tags: ["Localization"]
---

# GET /v1/translations

`GET /v1/translations`

## Request

- The document declares no server URL.
- Auth: none required
- TypeScript: <https://skmtc.dev/appcharge/apis/grant-award/docs/v1/translations/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of all translatable fields and their translations. 
 
 Use the `locale` parameter to return translations for a specific locale. If a field doesn't have a translation for the requested locale, the value defaults to English, `en`. 
 
  If no locale is specified, all translations are returned, including the default English values.

## Query parameters

- `locale` string

## Headers

- `x-publisher-token` string, required

## Response `200`

Translations retrieved successfully.

- TranslationResponse
  - `dynamicTranslations` DynamicTranslation[]: A list of translations for dynamic entities you define such as offer and product names.
    - `type` string: Entity type. Values include: 'offer', 'offer_design', 'product', 'section', 'builder', 'ribbon'
    - `externalId` string: The ID as defined in the Publisher Dashboard.
    - `field` string: The entity field the translation applies to. Values include: 'display_name', 'description', 'title', 'text', 'prefix', 'suffix'
    - `locale` string: The locale code. Both ISO-639 language code and ISO-3166 country code formats are supported.
    - `value` string: The translation text for the specified field and locale.
  - `staticTranslations` StaticTranslation[]: A list of translations for static UI elements such as button labels and headers.
    - `key` string: The key identifier for the static translation.
    - `locale` string: The locale code. Both ISO-639 language code and ISO-3166 country code formats are supported.
    - `value` string: The translation value associated with the key and locale.

## Other responses

- `400`: Invalid request payload.
- `401`: Missing or invalid authentication.
- `403`: Insufficient permissions.

---

[API](https://skmtc.dev/appcharge/apis/grant-award.md) - [All operations](https://skmtc.dev/appcharge/apis/grant-award/llms.txt) - [OpenAPI document](https://skmtc.dev/appcharge/apis/grant-award/revisions/b4f6759240d5?raw)