---
title: "Get file metadata"
method: POST
path: "/v2/project/files/info"
tags: ["Files"]
---

# Get file metadata

`POST /v2/project/files/info`

Get detailed metadata for specific source and translated files.

## Headers

- `gt-api-version` '2025-01-01.v0' | '2025-11-03.v1' | '2026-02-18.v1' | '2026-03-06.v1' — API contract version. Defaults to the oldest supported version.
- `gt-project-id` string — Target project ID. Required when authenticating with an organization API key; ignored with project-scoped API keys (the project is resolved from the key).

## Request body

- object
  - `sourceFiles` object[]
    - `fileId` string, required
    - `versionId` string, required
    - `branchId` string, required
  - `translatedFiles` object[]
    - `fileId` string, required
    - `versionId` string, required
    - `branchId` string, required
    - `locale` string, required

## Response `200`

File information

- object
  - `sourceFiles` object[], required
    - `branchId` string, required
    - `fileId` string, required
    - `versionId` string, required
    - `fileName` string, required
    - `fileFormat` 'GTJSON' | 'MDX' | 'JSON' | 'YAML' | 'MD' | 'TS' | 'JS' | 'HTML' | 'TXT' | 'PO' | 'POT' | 'TWILIO_CONTENT_JSON' | 'LOTTIE' | 'SVG' | 'XCSTRINGS', required
    - `dataFormat` string, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `publishedAt` string, date-time, nullable, required
    - `locales` string[], required
    - `sourceLocale` string, required
  - `translatedFiles` object[], required
    - `branchId` string, required
    - `fileId` string, required
    - `versionId` string, required
    - `fileFormat` 'GTJSON' | 'MDX' | 'JSON' | 'YAML' | 'MD' | 'TS' | 'JS' | 'HTML' | 'TXT' | 'PO' | 'POT' | 'TWILIO_CONTENT_JSON' | 'LOTTIE' | 'SVG' | 'XCSTRINGS', required
    - `dataFormat` string, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `approvedAt` string, date-time, nullable, required
    - `publishedAt` string, date-time, nullable, required
    - `completedAt` string, date-time, nullable, required
    - `locale` string, required

## Other responses

- `400` — Request error
- `401` — Request error
- `403` — Request error
- `413` — Request error
- `429` — Request error
- `500` — Request error

## Changes

- **2026-09-01** `e8f4ff6d5df2` — 2 warning
  - added the new `XCSTRINGS` enum value to the `sourceFiles/items/fileFormat` response property for the response status `200`
  - added the new `XCSTRINGS` enum value to the `translatedFiles/items/fileFormat` response property for the response status `200`
- **2026-08-27** `367cd605d090` — 7 breaking, 29 warning, 34 info
  - the `sourceFiles/items/branchId` request property's minLength was increased from `0` to `1`
  - the `sourceFiles/items/fileId` request property's minLength was increased from `0` to `1`
  - the `sourceFiles/items/versionId` request property's minLength was increased from `0` to `1`
  - the `translatedFiles/items/branchId` request property's minLength was increased from `0` to `1`
  - …66 more

[Change history](https://skmtc.dev/generaltranslation/apis/general-translation-api/changes/v2/project/files/info/post.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-service-production.skmtc.workers.dev/v1/apis/generaltranslation/general-translation-api/revisions/e8f4ff6d5df2/schema)