# General Translation Platform: Получить статус перевода
URL: https://generaltranslation.com/ru/docs/platform/openapi/reference/files/translation-status.mdx
---

title: Получить статус перевода
description: Проверяйте статус и доступность перевода по файлу и локали в проекте General Translation. Справочник API для метода «Получить статус перевода».

method: GET
---

Возвращает статус перевода для каждой локали одного исходного файла вместе с метаданными этого файла. Используйте этот метод, чтобы проверять, завершены ли переводы, одобрены ли они или опубликованы.

## Обзор [#overview]

```http
GET https://api2.gtx.dev/v2/project/translations/files/status/:fileId
```

**Разрешение** `project:files:read` · **Лимит запросов** По умолчанию (200/мин)

Отслеживайте прогресс перевода для одного файла. Чтобы сразу получить метаданные по нескольким файлам, используйте [Получить информацию о файле](/docs/platform/openapi/reference/files/file-info).

## Как это работает [#how-it-works]

* Исходный файл находится по `fileId` в указанной ветке. Если `branchId` не указан, используется ветка по умолчанию, а если не указан `versionId`, используется версия из HEAD этой ветки.
* Ответ содержит по одной записи для каждой локали исходного файла. Для локалей, у которых перевода пока нет, поля временных меток имеют значение `null`.
* Если исходный файл не найден, запрос возвращает `404`.

## Запрос [#request]

### Заголовки

| Заголовок         | Описание                                                              | Обязательно |
| ----------------- | --------------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | API-ключ проекта или организации.                                     | Да          |
| `x-gt-project-id` | Идентификатор проекта. Требуется при использовании ключа организации. | Нет         |

### Параметры пути

| Параметр | Описание                                                 | Тип      | Обязательный |
| -------- | -------------------------------------------------------- | -------- | ------------ |
| `fileId` | Постоянный идентификатор файла, который нужно проверить. | `string` | Да           |

### Параметры строки запроса

| Параметр    | Описание                        | Тип      | Необязателен | По умолчанию           |
| ----------- | ------------------------------- | -------- | ------------ | ---------------------- |
| `versionId` | Конкретная версия для проверки. | `string` | Да           | Последняя версия ветки |
| `branchId`  | Ветка для чтения.               | `string` | Да           | Ветка по умолчанию     |

## Ответ [#response]

**Статус** `200 OK`

```json title="Response"
{
  "translations": [
    {
      "locale": "es",
      "completedAt": "2026-01-01T00:00:00.000Z",
      "approvedAt": null,
      "publishedAt": null,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    }
  ],
  "sourceFile": {
    "id": "sf_...",
    "branchId": "br_...",
    "fileId": "file_...",
    "versionId": "ver_...",
    "fileName": "en/common.json",
    "sourceLocale": "en",
    "fileFormat": "JSON",
    "dataFormat": "JSON",
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "locales": ["es"]
  }
}
```

## Ошибки [#errors]

| Статус | Причина                                           |
| ------ | ------------------------------------------------- |
| `400`  | Отсутствует `fileId`.                             |
| `401`  | API-ключ отсутствует или недействителен.          |
| `403`  | У API-ключа нет разрешения `project:files:read`.  |
| `404`  | Исходный файл не найден или переводы отсутствуют. |
| `429`  | Превышен лимит запросов.                          |

## Пример [#example]

```bash
curl -X GET "https://api2.gtx.dev/v2/project/translations/files/status/file_...?branchId=br_..." \
  -H "x-gt-api-key: gtx-api-..."
```