# General Translation Platform: Récupérer l’état de traduction d’un fichier
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/files/translation-status.mdx
---

title: "Récupérer l’état de traduction d’un fichier"
description: "Renvoie la progression et la disponibilité des traductions par paramètre régional pour un fichier source, ainsi que ses métadonnées source. Référence de l’API pour Récupérer l’état de traduction d’un fichier."
method: GET
full: true
_openapi:
  method: GET
  route: /v2/project/translations/files/status/{fileId}
  toc: []
  structuredData:
    headings: []
    contents:
      - content: >
          Renvoie la progression et la disponibilité des traductions par paramètre régional pour un fichier source,
          ainsi que ses métadonnées source.
---



## `GET https://api.gtx.dev/v2/project/translations/files/status/{fileId}`

Return translation progress and availability by locale for one source file, along with its source metadata.

Authentication: send an API key as a bearer token in the `Authorization: Bearer <key>` header.

### Parameters

- `gt-api-version` (header, "2025-01-01.v0" | "2025-11-03.v1" | "2026-02-18.v1" | "2026-03-06.v1", optional): API version. Defaults to the earliest supported version. Latest is `2026-03-06.v1`.
- `gt-project-id` (header, string, optional): Target project ID. Required when authenticating with an organization API key.
- `fileId` (path, string, required): 
- `versionId` (query, string, optional): Defaults to the branch head version.
- `branchId` (query, string, optional): Defaults to the default branch.

### Responses

**200**: Translation status for the file.
Response body (`application/json`, object):
- `translations` (object[])
  - `locale` (string)
  - `completedAt` (string | null)
  - `approvedAt` (string | null)
  - `publishedAt` (string | null)
  - `createdAt` (string | null)
  - `updatedAt` (string | null)
- `sourceFile` (object)
  - `id` (string)
  - `branchId` (string)
  - `fileId` (string)
  - `versionId` (string)
  - `fileName` (string)
  - `sourceLocale` (string)
  - `fileFormat` (string)
  - `dataFormat` (string | null)
  - `createdAt` (string)
  - `updatedAt` (string)
  - `approvalRequiredAt` (string | null)
  - `locales` (string[])

**401**: Missing or invalid API key.
Response body (`application/json`, object):
- `error` (string): Human-readable error message.

**403**: The API key lacks the required permission, or the action is not allowed on the current plan.
Response body (`application/json`, object):
- `error` (string): Human-readable error message.

**404**: The requested resource was not found.
Response body (`application/json`, object):
- `error` (string): Human-readable error message.

The complete OpenAPI 3.1 spec is available at https://generaltranslation.com/openapi.yaml.