---
title: "Get file status"
method: GET
path: "/v2/projects/{projectId}/files/{fileId}/status"
tags: ["Files"]
---

# Get file status

`GET /v2/projects/{projectId}/files/{fileId}/status`

## Request

- Base URL: `https://api.gtx.dev`
- URL: `https://api.gtx.dev/v2/projects/{projectId}/files/{fileId}/status`
- Auth: HTTP bearer

Get a source file's metadata and the translation state of each locale. Requires `project:files:read`.

## Path parameters

- `projectId` string, required
- `fileId` string, required: File ID.

## Query parameters

- `branchId` string: Branch ID. Defaults to the project default branch.
- `versionId` string: Source version ID. Defaults to the branch head.

## Headers

- `gt-api-version` '2025-01-01.v0' | '2025-11-03.v1' | '2026-02-18.v1' | '2026-03-06.v1' | '2026-10-08.v1', required

## Response `200`

File status

- object
  - `translations` object[], required
    - `locale` string, required
    - `completedAt` string, date-time, nullable, required
    - `approvedAt` string, date-time, nullable, required
    - `publishedAt` string, date-time, nullable, required
    - `createdAt` string, date-time, nullable, required
    - `updatedAt` string, date-time, nullable, required
  - `sourceFile` object, required
    - `id` string, required
    - `branchId` string, required
    - `fileId` string, required
    - `versionId` string, required
    - `fileName` string, required
    - `sourceLocale` string, required
    - `fileFormat` 'GTJSON' | 'JSON' | 'YAML' | 'MD' | 'MDX' | 'TS' | 'JS' | 'HTML' | 'TXT' | 'PO' | 'POT' | 'TWILIO_CONTENT_JSON' | 'LOTTIE' | 'SVG' | 'XCSTRINGS' | 'DOT_STRINGS' | 'DOT_STRINGSDICT' | 'ANDROID_STRINGS' | 'SRT' | 'RESX' | 'PNG' | 'JPEG' | 'MP4', required
    - `dataFormat` 'JSX' | 'ICU' | 'I18NEXT' | 'STRING' | 'MESSAGE_TREE', required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `locales` string[], required

## Other responses

- `400`: The request is malformed or failed validation.
- `401`: Authentication is missing or invalid.
- `403`: The caller is authenticated but not allowed to perform this operation or access the requested resource.
- `404`: The requested resource was not found.
- `429`: Too many requests. The rate limit was exceeded.
- `500`: An unexpected server error occurred.

## Changes

- **2026-11-14** `1ebafb7f823e`: 1 warning
  - added the new `MESSAGE_TREE` enum value to the `sourceFile/dataFormat/anyOf[#/components/schemas/DataFormat]/` response property for the response status `200`
- **2026-11-06** `39f0059275f1`: 12 warning
  - added the new `invalid_content_encoding` enum value to the `allOf[#/components/schemas/ErrorResponse]/code` response property for the response status `400`
  - added the new `invalid_content_encoding` enum value to the `allOf[#/components/schemas/ErrorResponse]/code` response property for the response status `401`
  - added the new `invalid_content_encoding` enum value to the `allOf[#/components/schemas/ErrorResponse]/code` response property for the response status `403`
  - added the new `invalid_content_encoding` enum value to the `allOf[#/components/schemas/ErrorResponse]/code` response property for the response status `404`
  - …8 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/generaltranslation/apis/general-translation-api/changes/v2/projects/:projectId/files/:fileId/status/get.md)

---

[API](https://skmtc.dev/generaltranslation/apis/general-translation-api.md) - [All operations](https://skmtc.dev/generaltranslation/apis/general-translation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/generaltranslation/apis/general-translation-api/revisions/1ebafb7f823e?raw)
