# General Translation Platform: Obtener información del archivo
URL: https://generaltranslation.com/es/docs/platform/openapi/reference/files/file-info.mdx
---

title: Obtener información del archivo
description: Consulta los metadatos, las versiones, las configuraciones regionales y el estado de traducción de los archivos fuente de General Translation. Referencia de API para Obtener información del archivo.

method: POST
---

Devuelve los metadatos de archivos fuente y archivos traducidos a partir de una referencia. Consulta archivos fuente, archivos traducidos o ambos en una sola solicitud.

## Descripción general [#overview]

```http
POST https://api2.gtx.dev/v2/project/files/info
```

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

Consulta los metadatos del archivo sin descargar su contenido. Para ver el progreso de la traducción por configuración regional de un solo archivo, usa [Obtener el estado de la traducción](/docs/platform/openapi/reference/files/translation-status).

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

* Proporciona `sourceFiles`, `translatedFiles` o ambos. Cada lista se procesa de forma independiente y se devuelve en su propia lista.
* Solo se devuelven los archivos que existen; las referencias que no coincidan se omiten en lugar de generar un error.
* La respuesta contiene solo metadatos (configuraciones regionales, formatos y marcas de tiempo), no el contenido de los archivos.

## Solicitud [#request]

### Cabeceras

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

### Cuerpo

**Tipo de contenido** `application/json`

| Campo             | Descripción                                                | Tipo       | Opcional | Predeterminado |
| ----------------- | ---------------------------------------------------------- | ---------- | -------- | -------------- |
| `sourceFiles`     | Referencias de archivos fuente que se deben consultar.     | `object[]` | Sí       | —              |
| `translatedFiles` | Referencias de archivos traducidos que se deben consultar. | `object[]` | Sí       | —              |

Cada elemento de `sourceFiles` requiere `fileId`, `versionId` y `branchId`. Cada elemento de `translatedFiles` requiere `fileId`, `versionId`, `branchId` y `locale`. Ninguno de los valores puede estar vacío.

## Respuesta [#response]

**Estado** `200 OK`

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

## Errores [#errors]

| Estado | Causa                                     |
| ------ | ----------------------------------------- |
| `400`  | Consulta de archivo no válida.            |
| `401`  | Falta la API key o no es válida.          |
| `403`  | La API key no tiene `project:files:read`. |
| `429`  | Se superó el límite de solicitudes.       |

## Ejemplo [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/project/files/info \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "sourceFiles": [
      {
        "fileId": "file_...",
        "versionId": "ver_...",
        "branchId": "br_..."
      }
    ]
  }'
```