> 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/api-rest/identity-api/identity-api-reference/security-compliance/document-custody/download-document.md).

# Download Document

Servicio para descargar un documento almacenado utilizando la URL de descarga pre-firmada.

La URL de descarga es válida por **5 años** desde su generación. La respuesta es una redirección a la ubicación real del archivo.

{% hint style="info" %}
Cuando se utiliza en un navegador, el navegador seguirá la redirección de forma transparente para el usuario.
{% endhint %}

{% hint style="warning" %}
La URL de descarga contiene un token JWT válido por 5 años. Si se pierde la URL de descarga, no será posible recuperar el archivo.
{% endhint %}

### Endpoint

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

### Parámetros de ruta

| Parámetro       | Tipo   | Requerido | Descripción                                                      |
| --------------- | ------ | --------- | ---------------------------------------------------------------- |
| `downloadToken` | string | **Sí**    | Token de descarga de la URL pre-firmada (JWT válido por 5 años). |

### Respuestas

#### `302` Found

Redirige a la URL de descarga directa del archivo.

#### Headers de respuesta

| Header         | Tipo   | Descripción                          |
| -------------- | ------ | ------------------------------------ |
| `Location`     | string | URL de descarga directa del archivo. |
| `Content-Type` | string | Tipo de contenido del archivo.       |

#### `401` Unauthorized

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

#### `403` Forbidden

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

#### `404` Not Found

```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` Bad Gateway

```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` Gateway Timeout

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