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

# Documenti utente: ID, prova di residenza e allegati

> Documenti d'identità, prove di residenza e file di supporto degli utenti Didit: cosa viene raccolto, come recuperarli e caricarli dalla console.



Prompt per i documenti utente
        Copia il prompt negli appunti



      
      

\<pre>

\````# Goal — retrieve user documents and generate compliance PDFs

Documents (ID images, MRZ data, selfies, proof-of-address scans, NFC chip reads) are attached to the **session** that captured them, not directly to the User entity. There is no public "upload document to user" API — capture flows through sessions. You can however list sessions for the user, retrieve each session's decision, and pull signed URLs to the document images.

\## Pattern — list sessions for a user, then read each decision

\```bash
\# 1) List sessions tied to the User entity
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "vendor_data=user-42" \
\--data-urlencode "page_size=50"

\# 2) For each session, retrieve the full decision (V3 plural arrays)
curl https://verification.didit.me/v3/session/$SESSION_ID/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
\```

\## Where documents appear in the V3 decision

Inspect these plural arrays (every per-feature result is plural in V3):

\| Array | Contains |
\|---|---|
\| `id_verifications[]` | Government ID images, OCR fields, MRZ, expiry, issuing country |
\| `liveness_checks[]` | Selfie frames, passive liveness score |
\| `nfc_verifications[]` | NFC chip data, ICAO certificate chain |
\| `proof_of_address_checks[]` | POA document images, extracted address |

Image URLs are short-lived signed URLs — cache the bytes if you need them long-term, or re-fetch the decision when they expire.

\## Generate a PDF report

For a human-readable compliance export (used for SARs, audits, regulator requests):

\```bash
curl https://verification.didit.me/v3/session/$SESSION_ID/generate-pdf/ \
-H "x-api-key: $DIDIT_API_KEY" \
-o session-report.pdf
\```

The PDF includes session details, per-feature results, and embedded document images.

\## Re-verification / new document collection

To collect fresh documents (e.g. expired ID), create a new session for the same `vendor_data` — the new session attaches to the existing User entity:

\```bash
curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workflow_id": "$WORKFLOW_ID", "vendor_data": "user-42"}'
\```

\## Failure modes

\- `404` — wrong `session_id` or wrong `vendor_data` casing.
\- Expired signed image URL — re-fetch the decision to get fresh URLs.
\- `403` on PDF — your API key's role lacks PDF export permission.
\- Document monitoring is on by default and sends no warning before a document expires: when the ID's expiry date passes, the Approved session moves to "Kyc Expired" — see /core-technology/id-verification/document-monitoring-id-verification.

\## Response shape

See /reference/data-models for the full per-feature schema. Each plural-array item carries its own `status`, `document_images[]`, OCR extract, and decision metadata.

\## Sources of truth

\- /sessions-api/retrieve-session — decision schema
\- /reference/data-models — V3 plural-array contract
\- /core-technology/id-verification/overview — ID capture behaviour
\- /core-technology/proof-of-address/overview — POA capture
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

Incolla in

Ogni documento caricato da un utente durante la verifica è collegato in modo permanente alla sua entità User. Questa pagina spiega cosa viene raccolto, come recuperarlo e come caricare manualmente documenti aggiuntivi.## Cosa raccoglie Didit| Tipo di documento | Quando viene raccolto | Campi estratti |
| - | - | - |
| **Documento d'identità** (passaporto, carta d'identità nazionale, patente di guida, permesso di soggiorno) | Passaggio di [verifica dell'identità](https://docs.didit.me/it/core-technology/id-verification/overview.md) | Nome, data di nascita, numero del documento, paese di emissione, scadenza, MRZ dove presente |
| **Selfie / fotogrammi di rilevamento della vitalità** | Passaggio di [vitalità](https://docs.didit.me/it/core-technology/liveness/overview.md) | Ritaglio del volto più grande, punteggio di rilevamento della vitalità passiva |
| **Prova di residenza (POA)** | Passaggio di [POA](https://docs.didit.me/it/core-technology/proof-of-address/overview.md) | Nome, indirizzo, emittente, data del documento |
| **Lettura del chip NFC** | Passaggio di [verifica NFC](https://docs.didit.me/it/core-technology/nfc-verification/overview.md) | Dati del chip, catena di certificati ICAO, confronto con l'OCR |
| **Documenti aggiuntivi** | Richiesta dell'analista o passaggi di workflow personalizzati | OCR quando applicabile, altrimenti conservati così come sono |[Tipi di documento supportati](https://docs.didit.me/it/core-technology/id-verification/supported-documents-id-verification.md) coprono l'intera matrice paese × documento (14,000+ documenti in 220+ paesi).## Recupero dei documentiI documenti sono associati alla **sessione** che li ha raccolti, non direttamente all'utente. Per elencare tutti i documenti di un utente:**1. Elenca le sessioni dell'utente**```bash theme={null}
curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42"
```**2. Recupera la decisione di ogni sessione**La decisione di ogni sessione include gli URL dei documenti raccolti.```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```Controlla i campi `id_verification.document_images`, `proof_of_address.document_images` e `liveness.images` nella risposta.**3. Usa gli URL firmati**Gli URL delle immagini nella risposta sono URL firmati a breve durata. Memorizzali nella cache lato client per il tempo necessario al loro utilizzo oppure richiedi di nuovo la decisione quando scadono.## Generazione di un report PDFPer un'esportazione leggibile di tutto ciò che è stato raccolto per una sessione, inclusi tutti i documenti, usa:**`GET /v3/session/{session_id}/generate-pdf/`**Restituisce un PDF con i dettagli della sessione, i risultati delle funzionalità e le immagini dei documenti incorporate. È utile per audit di compliance, allegati SAR e pratiche normative.## Caricamento dei documenti dalla consoleGli operatori di compliance possono caricare documenti aggiuntivi per un utente o per una sessione attiva:1. Vai a *Users → \[user] → Documents → Upload document*.
2. Scegli un tipo di documento (ID, POA, personalizzato).
3. Carica un file: per i tipi supportati l'OCR viene eseguito automaticamente.
4. Il documento viene collegato alla sessione più recente (oppure puoi creare una sessione di remediation).> [!NOTE]
>
> L'interfaccia di caricamento dei documenti è disponibile solo nella console: non esiste un endpoint API pubblico per collegare direttamente documenti a un utente. Usa le sessioni come punto di partenza per tutte le acquisizioni di documenti.## Confronto incrociato dei documentiQuando una sessione raccoglie più tipi di documento, Didit li confronta tra loro:- **ID ↔ Rilevamento della vitalità**: il volto nel documento d'identità corrisponde al selfie per il rilevamento della vitalità.
- **ID ↔ POA**: il nome nella POA corrisponde al nome estratto dal documento d'identità.
- **ID ↔ NFC**: i dati MRZ / visivi corrispondono ai dati del chip NFC.Le incoerenze vengono segnalate come avvisi nella decisione della sessione e possono essere configurate per attivare una revisione manuale.## Monitoraggio dei documenti e nuova verificaPer casi d'uso che richiedono la validità continua dei documenti (ad es. documenti d'identità scaduti):- La **scadenza del documento** viene tracciata per ogni documento d'identità verificato. Interroga la decisione della sessione per il campo `expiration_date`.
- **Monitoraggio dei documenti**: attivo per impostazione predefinita e automatico, non occorre abilitare nulla. Quando la data di scadenza del documento d'identità viene superata, una sessione `"Approved"` passa a `"Kyc Expired"`, il risultato della verifica dell'ID riceve un avviso `DOCUMENT_EXPIRED` e viene inviato un webhook `status.updated`. Nessun avviso viene inviato prima che la data sia superata.
- **Disattivazione**: imposta **Expiration mode** su **Allow expired** per il paese e il tipo di documento interessati nelle [impostazioni della verifica dell'identità](https://docs.didit.me/it/core-technology/id-verification/overview.md). **Reject expired**, l'impostazione predefinita, è la modalità che attiva il monitoraggio. Un documento accettato con **Allow expired** non viene mai monitorato.
- **Nuova verifica**: avvia una nuova sessione con lo stesso `vendor_data` per aggiornare i documenti.## Geolocalizzazione del documentoIl controllo di [geolocalizzazione del documento d'identità](https://docs.didit.me/it/core-technology/id-verification/document-geolocation-id-verification.md) confronta la posizione IP di chi invia i dati con il paese di emissione del documento d'identità. I risultati vengono allegati alla decisione della sessione.## Privacy e conservazione- Tutti i documenti sono cifrati a riposo.
- L'accesso alle immagini avviene tramite URL firmati a breve durata.
- La conservazione segue la politica di [conservazione dei dati](https://docs.didit.me/it/console/data-retention.md) dell'applicazione.
- Gli utenti hanno il diritto di chiedere la cancellazione: la cancellazione rimuove immagini, estratti OCR e dati NFC.## Prossimi passi> [card] [Verifica dell'identità](https://docs.didit.me/it/core-technology/id-verification/overview.md)
>
> Come funzionano l'acquisizione del documento d'identità e l'OCR.> [card] [Prova di residenza](https://docs.didit.me/it/core-technology/proof-of-address/overview.md)
>
> Raccolta dei documenti POA.> [card] [Decisione della sessione](https://docs.didit.me/it/sessions-api/retrieve-session.md)
>
> Riferimento GET /v3/session/{id}/decision/.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.