# General Translation Platform: ファイルの翻訳ステータスを取得
URL: https://generaltranslation.com/ja/docs/platform/openapi/reference/files/translation-status.mdx
---

title: "ファイルの翻訳ステータスを取得"
description: "1 つのソースファイルのソースメタデータとともに、ロケール別の翻訳の進行状況と利用可否を返します。ファイルの翻訳ステータスを取得するための API リファレンス。"
method: GET
full: true
_openapi:
  method: GET
  route: /v2/project/translations/files/status/{fileId}
  toc: []
  structuredData:
    headings: []
    contents:
      - content: >
          1 つのソースファイルのソースメタデータとともに、ロケール別の翻訳の進行状況と
          利用可否を返します。
---



## `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.