# Elencare le mie esportazioni

`GET /fapi/v1/me/exports` · chiamato dall'host di accesso dell'ambiente

Restituisce le esportazioni dei dati dell'utente con sessione attiva degli ultimi 30 giorni, dalla più recente, al massimo 10. Compaiono solo le esportazioni richieste dall'utente; quelle avviate da un amministratore tramite l'API di gestione o la dashboard non sono elencate. Richiede il cookie `__Host-idp_session` dell'utente autenticato. Un'app di prima parte su un'altra origine può invece inviare il proprio token di accesso della Front API (`Authorization: DPoP <token>` con una prova DPoP; vedi [Token di accesso della Front API](/docs/api/fapi/front-api-token)). La lettura non richiede un accesso recente.

Ogni esportazione ha uno `status`: `queued` e `running` mentre viene preparata, `completed` quando il file può essere scaricato, `failed` con un `failure_reason` (`too_large`, `user_deleted`, `source_unavailable`, `attempts_exhausted`), ed `expired` una volta eliminato il file (7 giorni dopo il completamento). `file` riporta dimensione e SHA-256 del pacchetto quando è completata o scaduta.

## Richiesta

Intestazioni:

| Intestazione | Obbligatoria | Descrizione |
| --- | --- | --- |
| `Idp-Client` | sì | Identificatore dell'SDK. |

## Risposta

`200 OK`:

```json
{"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"}]}
```

## Errori

| Stato | Codice | Quando |
| --- | --- | --- |
| 401 | `unauthenticated` | Nessun cookie di sessione valido. |
| 503 | `service_unavailable` | La directory utenti è temporaneamente non disponibile; riprova dopo `Retry-After`. |

## Esempio

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

## Dati personali

Questo endpoint contiene dati personali: richieste sulla privacy (i registri di esportazione dell'utente stesso). [Dati personali nelle API di KeenAuth](/docs/policies/personal-data) descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene cancellato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in nessun campo.