---
title: "Download translated file (single locale or multi-locale)"
method: GET
path: "/files-api/v2/projects/{projectId}/locales/{localeIds}/file"
tags: ["Files"]
---

# Download translated file (single locale or multi-locale)

`GET /files-api/v2/projects/{projectId}/locales/{localeIds}/file`

Downloads the requested translated file from Smartling.  

This endpoint supports two modes depending on the value of `localeIds`:

### **Single-locale mode**
- Provide a **single locale ID**, e.g. `fr-FR`
- Smartling returns a file containing translations only for that locale
- Supported for **all file types**.

### **Multi-locale mode**
- Provide a **comma-separated list of locale IDs**, e.g. `fr-FR,de-DE,es-ES`
- Or specify `all` to include all available locales
- Smartling returns a **combined multi-locale file** with translations for all specified locales inside one file
- Supported only for:
  **MADCAP, DITA_ZIP, CSV, XLSX_TEMPLATE, XCSTRINGS**


---

It is important to check the HTTP response status code. If Smartling
finds and returns the file normally, you will receive a `200` SUCCESS
response. If you receive any other response status code other than
`200`, the requested file will not be part of the response.

When you upload a UTF-16 character encoded file, then /file/get requests
for that file will have a character encoding of UTF-16. All other
uploaded files will be returned with a character encoding of UTF-8.

You can always use the content-type header in the response of a file/get
request to determine the character encoding.

**Note**: The filename in the response header is based on the fileUri
associated with the requested file. In most cases, the filename is
exactly the fileUri provided. The only exception to this is with .pot
gettext files. When a .pot file is specified as the fileUri, Smartling
returns a .po file.

## Path parameters

- `projectId` string, required
- `localeIds` string, required

## Query parameters

- `fileUri` string, required
- `retrievalType` 'pending' | 'published' | 'pseudo' | 'contextMatchingInstrumented'
- `includeOriginalStrings` boolean

## Response `200`

OK

## Other responses

- `400` — Provided request parameters are invalid.
- `401` — Provided credentials are not valid.
- `429` — Too many simultaneous API requests.
- `500` — Unexpected error

---

[API](https://skmtc.net/smartling/apis/smartling-rest-api-reference.md) · [All operations](https://skmtc.net/smartling/apis/smartling-rest-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartling/smartling-rest-api-reference/versions/2a73d11e9b98/schema)