# General Translation Platform: Obtenir l’état de la traduction
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/files/translation-status.mdx
---

title: Obtenir l’état de la traduction
description: Vérifiez l’avancement et la disponibilité des traductions par fichier et par paramètre régional dans un projet General Translation. Référence API pour obtenir l’état de la traduction.

method: GET
---

Renvoie l’état de la traduction par paramètre régional pour un seul fichier source, ainsi que les métadonnées du fichier source. Utilisez-le pour vérifier si les traductions sont terminées, approuvées ou publiées.

## Vue d’ensemble [#overview]

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

**Autorisation** `project:files:read` · **Limite de requêtes** Par défaut (200/min)

Suivez l’avancement de la traduction d’un fichier. Pour consulter les métadonnées de plusieurs fichiers à la fois, utilisez [Obtenir les informations d’un fichier](/docs/platform/openapi/reference/files/file-info).

## Fonctionnement [#how-it-works]

* Le fichier source est identifié par `fileId` dans la branche indiquée. Si `branchId` n’est pas renseigné, la branche par défaut est utilisée, et si `versionId` n’est pas renseigné, la version en tête de la branche est utilisée.
* La réponse contient une entrée par paramètre régional pour le fichier source. Pour les paramètres régionaux sans traduction, les champs d’horodatage valent `null`.
* Si aucun fichier source n’est trouvé, la requête renvoie `404`.

## Requête [#request]

### En-têtes

| En-tête           | Description                                                               | Obligatoire |
| ----------------- | ------------------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | Clé API du projet ou de l’Organization.                                   | Oui         |
| `x-gt-project-id` | ID du projet. Obligatoire lors de l’utilisation d’une clé d’Organization. | Non         |

### Paramètres de chemin

| Paramètre | Description                               | Type     | Obligatoire |
| --------- | ----------------------------------------- | -------- | ----------- |
| `fileId`  | Identifiant stable du fichier à vérifier. | `string` | Oui         |

### Paramètres de requête

| Paramètre   | Description                   | Type     | Facultatif | Par défaut                 |
| ----------- | ----------------------------- | -------- | ---------- | -------------------------- |
| `versionId` | Version précise à vérifier.   | `string` | Oui        | Version en tête de branche |
| `branchId`  | Branche depuis laquelle lire. | `string` | Oui        | Branche par défaut         |

## Réponse [#response]

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

## Erreurs [#errors]

| État  | Cause                                                      |
| ----- | ---------------------------------------------------------- |
| `400` | `fileId` manquant.                                         |
| `401` | Clé API manquante ou invalide.                             |
| `403` | La clé API ne dispose pas de `project:files:read`.         |
| `404` | Aucun fichier source trouvé, ou aucune traduction trouvée. |
| `429` | Limite de requêtes dépassée.                               |

## Exemple [#example]

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