# General Translation Platform: Ottieni lo stato della traduzione
URL: https://generaltranslation.com/it/docs/platform/openapi/reference/files/translation-status.mdx
---

title: Ottieni lo stato della traduzione
description: Verifica lo stato di avanzamento e la disponibilità delle traduzioni per file e impostazione regionale in un progetto di General Translation. Riferimento API per ottenere lo stato della traduzione.

method: GET
---

Restituisce lo stato della traduzione per ogni impostazione regionale di un singolo file sorgente, insieme ai metadati del file sorgente. Usalo per verificare periodicamente se le traduzioni sono state completate, approvate o pubblicate.

## Panoramica [#overview]

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

**Permesso** `project:files:read` · **Limite di richieste** Predefinito (200/min)

Monitora l'avanzamento della traduzione di un file. Per consultare i metadati di più file contemporaneamente, usa [Ottieni informazioni sul file](/docs/platform/openapi/reference/files/file-info).

## Come funziona [#how-it-works]

* Il file sorgente viene individuato tramite `fileId` nel branch specificato. Se `branchId` non è specificato, viene usato il branch predefinito; se `versionId` non è specificato, viene usata la versione head del branch.
* La risposta elenca una voce per ogni impostazione regionale del file sorgente. Per le impostazioni regionali che non hanno ancora una traduzione, i campi timestamp sono `null`.
* Se non viene trovato alcun file sorgente, la richiesta restituisce `404`.

## Richiesta [#request]

### Header

| Header            | Descrizione                                                                  | Obbligatorio |
| ----------------- | ---------------------------------------------------------------------------- | ------------ |
| `x-gt-api-key`    | Chiave API del progetto o dell’organizzazione.                               | Sì           |
| `x-gt-project-id` | ID progetto. Obbligatorio quando si utilizza una chiave dell’organizzazione. | No           |

### Parametri del percorso

| Parametro | Descrizione                                    | Tipo     | Obbligatorio |
| --------- | ---------------------------------------------- | -------- | ------------ |
| `fileId`  | Identificatore stabile del file da verificare. | `string` | Sì           |

### Parametri di query

| Parametro   | Descrizione                        | Tipo     | Facoltativo | Predefinito              |
| ----------- | ---------------------------------- | -------- | ----------- | ------------------------ |
| `versionId` | Versione specifica da controllare. | `string` | Sì          | Versione head del branch |
| `branchId`  | Branch da cui leggere.             | `string` | Sì          | Branch predefinito       |

## Risposta [#response]

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

## Errori [#errors]

| Stato | Causa                                                           |
| ----- | --------------------------------------------------------------- |
| `400` | `fileId` mancante.                                              |
| `401` | Chiave API mancante o non valida.                               |
| `403` | La chiave API non dispone di `project:files:read`.              |
| `404` | Nessun file sorgente trovato oppure nessuna traduzione trovata. |
| `429` | Limite di richieste superato.                                   |

## Esempio [#example]

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