> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deepxl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Recuperación de archivos

> Recupera las cargas originales y los archivos generados a partir de los resultados del análisis

Cada análisis (detección de fraude, parsing, verificación) almacena los archivos asociados en el almacenamiento en la nube. Usa la API de Recuperación de Archivos para descargar las cargas originales y los recursos generados, como mapas de calor.

## Recuperar un archivo

Cada respuesta de análisis incluye un array `files` con URLs de descarga. Usa el nombre del archivo de la URL para recuperar el archivo:

```bash theme={null}
curl https://api.deepxl.ai/v1/files/fd_42_bank_statement.pdf \
  -H "x-api-key: YOUR_API_KEY" \
  --output bank_statement.pdf
```

El endpoint devuelve el archivo como un flujo binario con el encabezado `Content-Type` apropiado.

## Categorías de archivos

Los archivos en las respuestas de análisis se categorizan según su función:

| Categoría       | Servicio                     | Descripción                                                  |
| --------------- | ---------------------------- | ------------------------------------------------------------ |
| `original_file` | Detección de fraude, Parsing | El archivo que subiste originalmente                         |
| `heatmap`       | Detección de fraude          | Mapa de calor generado que resalta la manipulación detectada |
| `id`            | Verificación                 | La imagen del documento de identidad                         |
| `face`          | Verificación                 | La imagen de la selfie                                       |

## Encontrar URLs de archivos

Las URLs de archivos se incluyen en cada respuesta de análisis bajo el array `files`:

```json theme={null}
{
  "files": [
    {
      "category": "original_file",
      "fileName": "bank_statement.pdf",
      "fileSize": 245678,
      "contentType": "application/pdf",
      "timestamp": 1735689600000,
      "timestampISO": "2025-01-01T00:00:00.000Z",
      "url": "https://api.deepxl.ai/v1/files/fd_42_bank_statement.pdf"
    },
    {
      "category": "heatmap",
      "fileName": "fd_42_heatmap_1.png",
      "fileSize": 45678,
      "contentType": "image/png",
      "timestamp": 1735689601000,
      "timestampISO": "2025-01-01T00:00:01.000Z",
      "url": "https://api.deepxl.ai/v1/files/fd_42_heatmap_1.png"
    }
  ]
}
```

## Control de acceso

Los archivos están delimitados a tu organización. Solo puedes recuperar archivos asociados con tus propios análisis. Intentar acceder a los archivos de otra organización devuelve un `404`.