> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/api-rest/identity-api/identity-api-reference/security-compliance/document-custody/download-document.md).

# Baixar documento

Serviço para baixar um documento armazenado usando a URL de download pré-assinada.

A URL de download é válida por **5 anos** desde sua geração. A resposta é um redirecionamento para a localização real do arquivo.

{% hint style="info" %}
Quando usada em um navegador, o navegador seguirá o redirecionamento de forma transparente para o usuário.
{% endhint %}

{% hint style="warning" %}
A URL de download contém um Token JWT válido por 5 anos. Se a URL de download for perdida, não será possível recuperar o arquivo.
{% endhint %}

### Endpoint

```
GET /custody/download/{downloadToken}
```

### Parâmetros de rota

| Parâmetro       | Tipo   | Obrigatório | Descrição                                                      |
| --------------- | ------ | ----------- | -------------------------------------------------------------- |
| `downloadToken` | string | **Sim**     | Token de download da URL pré-assinada (JWT válido por 5 anos). |

### Respostas

#### `302` Encontrado

Redireciona para a URL de download direta do arquivo.

#### Cabeçalhos de resposta

| Cabeçalho      | Tipo   | Descrição                          |
| -------------- | ------ | ---------------------------------- |
| `Location`     | string | URL de download direta do arquivo. |
| `Content-Type` | string | Tipo de conteúdo do arquivo.       |

#### `401` Não autorizado

```json
{
  "message": "Unauthorized"
}
```

#### `403` Acesso negado

```json
{
  "Message": "User is not authorized to access this resource with an explicit deny"
}
```

#### `404` Não encontrado

```json
{
  "status": 404,
  "title": "Not Found",
  "detail": "Document doesn't exist.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404",
  "errors": []
}
```

#### `502` Gateway inválido

```json
{
  "status": 502,
  "title": "Bad Gateway",
  "detail": "Server got an invalid response.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502"
}
```

#### `504` Tempo limite do gateway

```json
{
  "message": "Endpoint request timed out"
}
```