---
title: "Show status of an async locale download"
method: GET
path: "/projects/{project_id}/locales/{locale_id}/downloads/{id}"
tags: ["Locale Downloads"]
---

# Show status of an async locale download

`GET /projects/{project_id}/locales/{locale_id}/downloads/{id}`

## Request

- Base URL: `https://eu.phrase.com/control-hub`
- URL: `https://eu.phrase.com/control-hub/projects/{project_id}/locales/{locale_id}/downloads/{id}`
- Auth: none required
- TypeScript: <https://skmtc.dev/phrase/apis/control-hub-service/docs/projects/:project_id/locales/:locale_id/downloads/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Show status of already started async locale download. If the download is finished, the download link will be returned.

## Path parameters

- `project_id` string, required
- `locale_id` string, required
- `id` string, required

## Headers

- `X-PhraseApp-OTP` string
- `If-Modified-Since` string
- `If-None-Match` string

## Response `200`

OK

- LocaleDownload
  - `id` string
  - `status` 'processing' | 'completed' | 'error': The status of the download request. Possible values are `processing`, `completed`, and `error`.
  - `result` object
    - `url` string, uri: The URL to the download file. This URL is valid for 15 minutes.
  - `params` object: The parameters of the download request.
    - `file_format` string
    - `locale_id` string
    - `tags` string
    - `branch` string
    - `include_empty_translations` boolean
    - `include_translated_keys` boolean
    - `include_unverified_translations` boolean
  - `error` string
  - `created_at` string, date-time
  - `completed_at` string, date-time

## Other responses

- `400`: Bad request. The request could not be parsed or a parameter failed validation. Verify the request body, the content type, and the parameter types, then retry.
- `401`: Unauthorized. Authentication failed because the access token is missing, expired, or invalid. Supply a valid access token and retry.
- `403`: Forbidden. The credentials are valid but not permitted for this request: the access token may lack the required scope, the user may lack permission on the resource, or the account plan may not include the feature. Use a token with the required scope on an account and user that hold the necessary permissions.
- `404`: Not found. The requested resource does not exist or is not visible to the authenticated user. Verify the identifiers in the request path and that the token has access to them, then retry.
- `410`: Gone. The async download has expired (downloads are retained for a limited time after completion) and can no longer be retrieved. Issue a new download request.
- `429`: Too many requests. The rate limit has been exceeded. Wait until the time indicated by the `X-Rate-Limit-Reset` response header before retrying.

---

[API](https://skmtc.dev/phrase/apis/control-hub-service.md) - [All operations](https://skmtc.dev/phrase/apis/control-hub-service/llms.txt) - [OpenAPI document](https://skmtc.dev/phrase/apis/control-hub-service/revisions/98ecac7ba2bf?raw)