> ## 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.

# Documents d'usuari: identitat, comprovants i fitxers

> Documents d'usuari a Didit: identificacions, comprovants de domicili i fitxers. Què es recull, com recuperar-los i pujar-los des de la consola.



Prompt de documents d'usuari
        Copia el prompt al porta-retalls



      
      

\<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>



      
      

Enganxa a

Cada document que un usuari puja durant la verificació queda vinculat de manera permanent a la seva entitat d'usuari. Aquesta pàgina explica què es recull, com es recuperen els documents i com es pugen manualment documents addicionals.## Què recull Didit| Tipus de document | Quan es recull | Camps extrets |
| - | - | - |
| **Document d'identitat oficial** (passaport, document nacional d'identitat, permís de conducció, permís de residència) | Pas de [Verificació d'identitat](https://docs.didit.me/ca/core-technology/id-verification/overview.md) | Nom, data de naixement, número de document, país emissor, data de caducitat, MRZ quan n'hi ha |
| **Selfie / fotogrames de prova de vida** | Pas de [Prova de vida](https://docs.didit.me/ca/core-technology/liveness/overview.md) | Retall facial més gran, puntuació de prova de vida passiva |
| **Comprovant de domicili (POA)** | Pas de [POA](https://docs.didit.me/ca/core-technology/proof-of-address/overview.md) | Nom, adreça, emissor, data del document |
| **Lectura del xip NFC** | Pas de [Verificació NFC](https://docs.didit.me/ca/core-technology/nfc-verification/overview.md) | Dades del xip, cadena de certificats ICAO, coincidència amb l'OCR |
| **Documents addicionals** | Sol·licitud d'un analista o passos d'un flux personalitzat | OCR quan s'aplica; en cas contrari, s'emmagatzemen tal com són |[Tipus de document compatibles](https://docs.didit.me/ca/core-technology/id-verification/supported-documents-id-verification.md) cobreix la matriu completa de país × document (14,000+ documents en 220+ països).## Recuperar documentsEls documents s'associen a la **sessió** que els va recollir, no directament a l'usuari. Per llistar tots els documents d'un usuari:**1. Llista les sessions de l'usuari**```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. Obté la decisió de cada sessió**Cada decisió de sessió inclou les URL dels documents recollits.```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```Revisa els camps `id_verification.document_images`, `proof_of_address.document_images` i `liveness.images` de la resposta.**3. Usa URL signades**Les URL d'imatge de la resposta són URL signades de vida curta. Guarda-les en memòria cau al client durant el temps que les necessitis, o torna a obtenir la decisió quan caducin.## Generar un informe PDFPer a una exportació llegible per humans de tot el que s'ha recollit en una sessió, inclosos tots els documents, utilitza:**`GET /v3/session/{session_id}/generate-pdf/`**Retorna un PDF amb els detalls de la sessió, els resultats de les funcionalitats i les imatges dels documents incrustades. És útil per a auditories de compliment, adjunts de SAR i presentacions davant dels organismes reguladors.## Pujar documents des de la consolaEls operadors de compliment poden pujar documents addicionals a un usuari o a una sessió activa:1. Ves a *Users → \[user] → Documents → Upload document*.
2. Tria un tipus de document (ID, POA, personalitzat).
3. Puja un fitxer; l'OCR s'executa automàticament per als tipus compatibles.
4. El document s'adjunta a la sessió més recent (o pots crear una sessió de remediació).> [!NOTE]
>
> La interfície de pujada de documents és només de la consola: no hi ha cap endpoint d'API públic per adjuntar documents directament a un usuari. Utilitza les sessions com a punt d'entrada per a totes les captures de documents.## Creuament de documentsQuan una sessió recull diversos tipus de document, Didit els creua:- **ID ↔ Prova de vida**: la cara del document d'identitat coincideix amb la selfie de la prova de vida.
- **ID ↔ POA**: el nom del POA coincideix amb el nom extret de l'ID.
- **ID ↔ NFC**: les dades MRZ o visuals coincideixen amb les dades del xip NFC.Les inconsistències es mostren com a advertències a la decisió de la sessió i es poden configurar perquè activin la revisió manual.## Monitoratge de documents i reverificacióPer als casos d'ús que requereixen validesa contínua dels documents (p. ex., documents d'identitat caducats):- **Caducitat del document**: es fa seguiment de la caducitat de cada ID verificat. Consulta el camp `expiration_date` de la decisió de la sessió.
- **Monitoratge de documents**: activat per defecte i automàtic; no cal habilitar-lo. Quan passa la data de caducitat de l'ID, una sessió `"Approved"` passa a `"Kyc Expired"`, el resultat de la verificació d'identitat rep una advertència `DOCUMENT_EXPIRED` i s'activa un webhook `status.updated`. Abans que passi la data no s'envia cap advertència.
- **Desactivar-lo**: estableix **Expiration mode** a **Allow expired** per al país i el tipus de document a la [configuració de la verificació d'identitat](https://docs.didit.me/ca/core-technology/id-verification/overview.md). **Reject expired**, el valor per defecte, és el mode que fa el monitoratge. Un document acceptat amb **Allow expired** mai no es monitoritza.
- **Reverificació**: activa una sessió nova amb el mateix `vendor_data` per actualitzar els documents.## Geolocalització del documentLa comprovació de [geolocalització del document d'identitat](https://docs.didit.me/ca/core-technology/id-verification/document-geolocation-id-verification.md) compara la ubicació IP de qui envia la informació amb el país emissor de l'ID. Els resultats s'adjunten a la decisió de la sessió.## Privacitat i conservació- Tots els documents estan xifrats en repòs.
- L'accés a les imatges es fa mitjançant URL signades de vida curta.
- La conservació segueix la política de [conservació de dades](https://docs.didit.me/ca/console/data-retention.md) de l'aplicació.
- Els usuaris tenen dret a sol·licitar la supressió; la supressió elimina les imatges, les extraccions OCR i les dades NFC.## Següents passos> [card] [Verificació d'identitat](https://docs.didit.me/ca/core-technology/id-verification/overview.md)
>
> Com funcionen la captura d'ID i l'OCR.> [card] [Comprovant de domicili](https://docs.didit.me/ca/core-technology/proof-of-address/overview.md)
>
> Recollida de documents POA.> [card] [Decisió de la sessió](https://docs.didit.me/ca/sessions-api/retrieve-session.md)
>
> Referència de GET /v3/session/{id}/decision/.


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