
# Descargar una exportación

`GET /fapi/v1/me/exports/{export_id}/download` · llamado desde el host de inicio de sesión del entorno

Devuelve el paquete ZIP de una de las exportaciones completadas del usuario que ha iniciado sesión, como archivo adjunto (`Content-Type: application/zip`, `Content-Disposition: attachment; filename="user-export-job_….zip"`). Compare el archivo con `file.sha256` de la exportación para comprobarlo. Cada descarga se registra en el registro de auditoría del entorno antes de enviar el primer byte. Si la transferencia se interrumpe, la conexión se cierra para que un archivo parcial nunca parezca completo; descárguelo de nuevo.

Requiere un inicio de sesión reciente, igual que la solicitud: si la sesión no se verificó en los últimos 5 minutos, o si el usuario tiene un segundo factor y la sesión no lo usó, la respuesta es `401 step_up_required`. `HEAD` no es compatible (`405`).

## Solicitud

Encabezados:

| Encabezado | Obligatorio | Descripción |
| --- | --- | --- |
| `Idp-Client` | sí | Identificador del SDK. |

## Respuesta

`200 OK` con el archivo ZIP como cuerpo.

## Errores

| Estado | Código | Cuándo |
| --- | --- | --- |
| 401 | `unauthenticated` | No hay una cookie de sesión válida. |
| 401 | `step_up_required` | El inicio de sesión tiene más de 5 minutos, o se requiere un segundo factor; el encabezado `WWW-Authenticate` incluye `max_age=300` (y `acr_values` cuando se requiere un segundo factor). |
| 404 | `not_found` | No existe esta exportación del usuario. |
| 409 | `conflict` | La exportación aún no está completada o su archivo ha caducado. |
| 503 | `service_unavailable` | El directorio de usuarios no está disponible temporalmente; reintente después de `Retry-After`. |

## Ejemplo

```bash
curl -OJ https://example.keenauth.app/fapi/v1/me/exports/job_01jbx4k6v8m2c9w5s7r3t1q0zy/download \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt
```

## Datos personales

Este endpoint contiene datos personales: perfil del usuario final, credenciales, identidades vinculadas, sesiones, membresías y invitaciones de organizaciones, registros de consentimiento, registros del entorno y solicitudes de privacidad (el paquete contiene los datos propios del usuario de cada uno de estos tipos). [Datos personales en las API de KeenAuth](/docs/policies/personal-data) describe qué se almacena, cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.
