Listar mis exportaciones
GET /fapi/v1/me/exports · llamado desde el host de inicio de sesión del entorno
Devuelve las exportaciones de datos propias del usuario que ha iniciado sesión de los últimos 30 días, de la más reciente a la más antigua, como máximo 10. Solo aparecen las exportaciones que el usuario solicitó; las exportaciones que un administrador inició a través de la API de gestión o del panel no se listan. Requiere la cookie __Host-idp_session del usuario autenticado. Una aplicación de origen propio en otro origen puede enviar en su lugar su token de acceso a la API frontal (Authorization: DPoP <token> con una prueba DPoP; consulte Token de acceso a la API frontal). La lectura no necesita un inicio de sesión reciente.
Cada exportación tiene un status: queued y running mientras se prepara, completed cuando el archivo se puede descargar, failed con un failure_reason (too_large, user_deleted, source_unavailable, attempts_exhausted), y expired una vez eliminado el archivo (7 días después de completarse). file incluye el tamaño del paquete y su SHA-256 cuando está completado o caducado.
Solicitud
Encabezados:
| Encabezado | Obligatorio | Descripción |
|---|---|---|
Idp-Client |
sí | Identificador del SDK. |
Respuesta
200 OK:
{"data": [{"id": "job_01jbx4k6v8m2c9w5s7r3t1q0zy", "status": "completed",
"file": {"size": 48213, "sha256": "9f2c5e0d4b1a7c3e8f6d2b0a9c4e1f7d3b5a8c2e6f0d4b9a1c7e3f5d2b8a0c6e"},
"failure_reason": null, "created_at": "2026-11-03T09:30:00Z", "started_at": "2026-11-03T09:30:02Z",
"completed_at": "2026-11-03T09:30:09Z", "expires_at": "2026-11-10T09:30:09Z"}]}
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 401 | unauthenticated |
No hay una cookie de sesión válida. |
| 503 | service_unavailable |
El directorio de usuarios no está disponible temporalmente; reintente después de Retry-After. |
Ejemplo
curl https://example.keenauth.app/fapi/v1/me/exports \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
Datos personales
Este endpoint contiene datos personales: solicitudes de privacidad (los registros de exportación propios del usuario). Datos personales en las API de KeenAuth 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.