---
title: "Download multiple files"
method: POST
path: "/v2/project/files/download"
tags: ["Files"]
---

# Download multiple files

`POST /v2/project/files/download`

Download up to 100 source or translated files in one request.

## 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 when no project ID is present in the path. Project API keys default to their bound project. If supplied, the header must match both the path target and the key’s bound project.

## Request body

- object[]
  - `fileId` string, required
  - `branchId` string
  - `versionId` string
  - `locale` string
  - `useLatestAvailableVersion` boolean

## Response `200`

Downloaded files

- object
  - `files` object[], required
    - `id` string, required
    - `branchId` string, required
    - `fileId` string, required
    - `versionId` string, required
    - `locale` string
    - `fileName` string
    - `data` string, required
    - `metadata` JsonObject, required
    - `fileFormat` 'GTJSON' | 'MDX' | 'JSON' | 'YAML' | 'MD' | 'TS' | 'JS' | 'HTML' | 'TXT' | 'PO' | 'POT' | 'TWILIO_CONTENT_JSON' | 'LOTTIE' | 'SVG' | 'XCSTRINGS' | 'DOT_STRINGS' | 'DOT_STRINGSDICT' | 'ANDROID_STRINGS' | 'SRT', required
  - `count` number, required
  - `pending` object[]
    - `branchId` string, required
    - `fileId` string, required
    - `locale` string, required
    - `versionId` 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-26** `4587bc8b9f53` — 1 info
  - the endpoint scheme security `UserBearerAuth` was removed from the API
- **2026-09-25** `d2afdba8c62b` — 1 warning
  - added the new `SRT` enum value to the `files/items/fileFormat` response property for the response status `200`
- **2026-09-09** `1f85b1892342` — 1 info
  - the endpoint scheme security `UserBearerAuth` was added to the API
- **2026-09-03** `451f820cc197` — 3 warning, 2 info
  - added the new `ANDROID_STRINGS` enum value to the `files/items/fileFormat` response property for the response status `200`
  - added the new `DOT_STRINGS` enum value to the `files/items/fileFormat` response property for the response status `200`
  - added the new `DOT_STRINGSDICT` enum value to the `files/items/fileFormat` response property for the response status `200`
  - removed the `APPLE_STRINGS` enum value from the `files/items/fileFormat` response property for the response status `200`
  - …1 more
- **2026-09-02** `330945a211d3` — 2 warning
  - added the new `APPLE_STRINGS` enum value to the `files/items/fileFormat` response property for the response status `200`
  - added the new `APPLE_STRINGSDICT` enum value to the `files/items/fileFormat` response property for the response status `200`

[Full history](https://skmtc.dev/generaltranslation/apis/general-translation-api/changes/v2/project/files/download/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.dev/generaltranslation/apis/general-translation-api/revisions/4587bc8b9f53?raw)