# General Translation Platform: Consultar el estado de la traducción
URL: https://generaltranslation.com/es/docs/platform/openapi/reference/files/translation-status.mdx
---

title: Consultar el estado de la traducción
description: Consulte el progreso y la disponibilidad de la traducción por archivo y configuración regional en un proyecto de General Translation. Referencia de la API para consultar el estado de la traducción.

method: GET
---

Devuelve el estado de la traducción por configuración regional de un único archivo fuente, junto con los metadatos del archivo fuente. Úselo para comprobar si las traducciones se han completado, aprobado o publicado.

## Resumen [#overview]

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

**Permiso** `project:files:read` · **Límite de solicitudes** Predeterminado (200/min)

Sigue el progreso de la traducción de un archivo. Para consultar los metadatos de varios archivos a la vez, usa [Obtener información del archivo](/docs/platform/openapi/reference/files/file-info).

## Cómo funciona [#how-it-works]

* El archivo fuente se determina a partir de `fileId` en la rama indicada. Si no se proporciona `branchId`, se usa la rama predeterminada; si no se proporciona `versionId`, se usa la versión HEAD de la rama.
* La respuesta enumera una entrada por configuración regional del archivo fuente. Para las configuraciones regionales que aún no tienen traducción, los campos de marca temporal son `null`.
* Si no se encuentra ningún archivo fuente, la solicitud devuelve `404`.

## Solicitud [#request]

### Cabeceras

| Cabecera          | Descripción                                                           | Obligatorio |
| ----------------- | --------------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | clave de API del proyecto o de Organization.                          | Sí          |
| `x-gt-project-id` | ID del proyecto. Obligatorio cuando se usa una clave de Organization. | No          |

### Parámetros de ruta

| Parámetro | Descripción                                              | Tipo     | Obligatorio |
| --------- | -------------------------------------------------------- | -------- | ----------- |
| `fileId`  | Identificador estable del archivo que se va a comprobar. | `string` | Sí          |

### Parámetros de consulta

| Parámetro   | Descripción                               | Tipo     | Opcional | Predeterminado          |
| ----------- | ----------------------------------------- | -------- | -------- | ----------------------- |
| `versionId` | Versión específica que se debe comprobar. | `string` | Sí       | Versión HEAD de la rama |
| `branchId`  | Rama de la que se leerá.                  | `string` | Sí       | Rama predeterminada     |

## Respuesta [#response]

**Estado** `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"]
  }
}
```

## Errores [#errors]

| Estado | Causa                                                                  |
| ------ | ---------------------------------------------------------------------- |
| `400`  | Falta `fileId`.                                                        |
| `401`  | Falta la clave de API o no es válida.                                  |
| `403`  | La clave de API no tiene `project:files:read`.                         |
| `404`  | No se encontró ningún archivo fuente o no se encontraron traducciones. |
| `429`  | Se excedió el límite de solicitudes.                                   |

## Ejemplo [#example]

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