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

title: 翻訳ステータスを取得
description: General Translation Project で、ファイルおよびロケールごとの翻訳の進捗状況と利用可否を確認します。「翻訳ステータスを取得」の API リファレンスです。

method: GET
---

単一のソースファイルに対するロケールごとの翻訳ステータスを、ソースファイルのメタデータとあわせて返します。翻訳が完了、承認済み、または公開済みかどうかをポーリングして確認する際に使用します。

## 概要 [#overview]

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

**権限** `project:files:read` · **レート制限** デフォルト (200/分)

1 つのファイルの翻訳の進行状況を追跡します。複数のファイルのメタデータをまとめて確認するには、[ファイル情報を取得](/docs/platform/openapi/reference/files/file-info) を使用します。

## 仕組み [#how-it-works]

* ソースファイルは、指定されたブランチ上で `fileId` によって特定されます。`branchId` が指定されていない場合はデフォルトブランチが使用され、`versionId` が指定されていない場合はブランチの先頭バージョンが使用されます。
* レスポンスには、ソースファイルの各ロケールごとに 1 つのエントリが含まれます。まだ翻訳が存在しないロケールでは、タイムスタンプフィールドは `null` になります。
* ソースファイルが見つからない場合、リクエストは `404` を返します。

## リクエスト [#request]

### ヘッダー

| ヘッダー              | 説明                                    | 必須  |
| ----------------- | ------------------------------------- | --- |
| `x-gt-api-key`    | プロジェクトまたは Organization のAPIキー。        | はい  |
| `x-gt-project-id` | プロジェクトID。Organization キーを使用する場合に必要です。 | いいえ |

### パスパラメータ

| パラメータ    | 説明              | 型        | 必須 |
| -------- | --------------- | -------- | -- |
| `fileId` | 確認対象の固定ファイル識別子。 | `string` | はい |

### クエリパラメータ

| パラメータ       | 説明                | 型        | 任意 | デフォルト        |
| ----------- | ----------------- | -------- | -- | ------------ |
| `versionId` | 確認するバージョンを指定します。  | `string` | はい | ブランチの先頭バージョン |
| `branchId`  | 読み取り元のブランチを指定します。 | `string` | はい | デフォルトブランチ    |

## レスポンス [#response]

**ステータス** `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"]
  }
}
```

## エラー [#errors]

| ステータス | 原因                                     |
| ----- | -------------------------------------- |
| `400` | `fileId` がありません。                       |
| `401` | API キーがないか、無効です。                       |
| `403` | API キーに `project:files:read` 権限がありません。 |
| `404` | ソースファイルまたは翻訳が見つかりません。                  |
| `429` | レート制限を超えました。                           |

## 例 [#example]

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