---
title: "Download translations for a language in a specified file format"
method: GET
path: "/v1/projects/{project_id}/files/download"
tags: ["Download API"]
---

# Download translations for a language in a specified file format

`GET /v1/projects/{project_id}/files/download`

<b>Note:</b> This endpoint is intended for getting translation files to your source-code. This endpoint should not be called directly from you app in runtime, as it has <b>rate-limiting</b>. <br/>For over-the-air translation updates please consider using our <a href="https://localizely.com/flutter-over-the-air/" target="_blank">SDK for Flutter</a> or <a href="https://localizely.com/aws-s3-integration/" target="_blank">integrate with AWS S3 bucket</a>.

## Path parameters

- `project_id` string, required

## Query parameters

- `branch` string
- `lang_codes` string
- `type` 'android_xml' | 'ios_strings' | 'ios_stringsdict' | 'java_properties' | 'rails_yaml' | 'angular_xlf' | 'flutter_arb' | 'dotnet_resx' | 'po' | 'pot' | 'json' | 'csv' | 'xlsx', required
- `java_properties_encoding` 'utf_8' | 'latin_1'
- `include_tags` string[]
- `exclude_tags` string[]
- `export_empty_as` 'empty' | 'main' | 'skip'

## Response `200`

OK, file returned

## Other responses

- `400` — Error codes:<br />&nbsp;<br />- `file_download_excel_cell_too_long` when some translations exceed Excel cell limit (returns int parameter: 'errorData.cellCharsLimit')<br />- `invalid_export_data_rails_yaml` when data collision for yaml download<br />- `bad_request` when request generally is not well formed
- `404` — Not Found

## Changes

- **2026-08-17** `8473a4c4d4f9` — 4 warning
  - added the new `qa_checks_failed` enum value to the `errorCode` response property for the response status `400`
  - added the new `qa_checks_failed` enum value to the `errorCode` response property for the response status `404`
  - added the new `qa_checks_not_supported` enum value to the `errorCode` response property for the response status `400`
  - added the new `qa_checks_not_supported` enum value to the `errorCode` response property for the response status `404`

[Change history](https://skmtc.dev/localizely/apis/localizely-api/changes/v1/projects/:project_id/files/download/get.md)

---

[API](https://skmtc.dev/localizely/apis/localizely-api.md) · [All operations](https://skmtc.dev/localizely/apis/localizely-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/localizely/localizely-api/revisions/8473a4c4d4f9/schema)