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

# Documentos de usuario: ID, domicilio y archivos de apoyo

> Didit guarda documentos de identidad, comprobantes de domicilio y archivos de apoyo por usuario: qué se recopila, cómo obtenerlos y subirlos.



Prompt de documentos del usuario
        Copiar el prompt al portapapeles



      
      

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



      
      

Pegar en

Cada documento que un usuario sube durante la verificación queda vinculado de forma permanente a su entidad de usuario. Esta página explica qué se recopila, cómo obtenerlo y cómo subir documentos adicionales manualmente.## Qué recopila Didit| Tipo de documento | Cuándo se recopila | Campos extraídos |
| - | - | - |
| **Documento de identidad oficial** (pasaporte, documento nacional de identidad, licencia de conducir, permiso de residencia) | Paso de [Verificación de identidad](https://docs.didit.me/es/core-technology/id-verification/overview.md) | Nombre, fecha de nacimiento, número de documento, país emisor, fecha de caducidad, MRZ cuando existe |
| **Selfie / fotogramas de prueba de vida** | Paso de [Prueba de vida](https://docs.didit.me/es/core-technology/liveness/overview.md) | Recorte facial más grande, puntuación de prueba de vida pasiva |
| **Prueba de domicilio (POA)** | Paso de [Prueba de domicilio](https://docs.didit.me/es/core-technology/proof-of-address/overview.md) | Nombre, dirección, emisor, fecha del documento |
| **Lectura del chip NFC** | Paso de [Verificación NFC](https://docs.didit.me/es/core-technology/nfc-verification/overview.md) | Datos del chip, cadena de certificados ICAO, coincidencia con el OCR |
| **Documentos adicionales** | Solicitud de un analista o pasos personalizados del flujo | OCR cuando corresponde; en caso contrario, se almacenan tal cual |[Tipos de documentos admitidos](https://docs.didit.me/es/core-technology/id-verification/supported-documents-id-verification.md) recoge la matriz completa de países × documentos (14,000+ documentos en 220+ países).## Obtener documentosLos documentos están asociados a la **sesión** que los recopiló, no directamente al usuario. Para listar todos los documentos de un usuario:**1. Lista las sesiones del usuario**```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én la decisión de cada sesión**La decisión de cada sesión incluye las URL de los documentos recopilados.```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```Revisa los campos `id_verification.document_images`, `proof_of_address.document_images` y `liveness.images` de la respuesta.**3. Usa URL firmadas**Las URL de las imágenes en la respuesta son URL firmadas de corta duración. Guárdalas en caché en el cliente mientras las uses, o vuelve a obtener la decisión cuando expiren.## Generar un informe en PDFPara una exportación legible de todo lo recopilado en una sesión, incluidos todos los documentos, usa:**`GET /v3/session/{session_id}/generate-pdf/`**Devuelve un PDF con los detalles de la sesión, los resultados de las funciones y las imágenes de los documentos incrustadas. Resulta útil para auditorías de cumplimiento, anexos de SAR y presentaciones regulatorias.## Subir documentos desde la consolaLos operadores de cumplimiento pueden subir documentos adicionales a un usuario o a una sesión activa:1. Ve a *Users → \[user] → Documents → Upload document*.
2. Elige un tipo de documento (documento de identidad, POA, personalizado).
3. Sube un archivo; el OCR se ejecuta automáticamente para los tipos admitidos.
4. El documento se adjunta a la sesión más reciente (o puedes crear una sesión de corrección).> [!NOTE]
>
> La interfaz de subida de documentos solo está disponible en la consola: no existe ningún endpoint público de la API para adjuntar documentos directamente a un usuario. Usa las sesiones como punto de entrada para toda captura de documentos.## Verificación cruzada de documentosCuando una sesión recopila varios tipos de documentos, Didit los contrasta entre sí:- **Documento de identidad ↔ Prueba de vida**: el rostro del documento de identidad coincide con la selfie de la prueba de vida.
- **Documento de identidad ↔ POA**: el nombre de la POA coincide con el nombre extraído del documento de identidad.
- **Identidad ↔ NFC**: los datos de la MRZ y visuales coinciden con los datos del chip NFC.Las incoherencias se muestran como advertencias en la decisión de la sesión y pueden configurarse para que activen una revisión manual.## Monitorización de documentos y reverificaciónPara casos de uso que requieren que los documentos sigan siendo válidos (p. ej., documentos de identidad expirados):- **Caducidad del documento**: se registra en cada documento de identidad verificado. Consulta el campo `expiration_date` en la decisión de la sesión.
- **Monitorización de documentos**: activada por defecto y automática; no hay que habilitar nada. Cuando pasa la fecha de caducidad del documento, una sesión `"Approved"` pasa a `"Kyc Expired"`, el resultado de la verificación de identidad recibe una advertencia `DOCUMENT_EXPIRED` y se envía un webhook `status.updated`. No se envía ninguna advertencia antes de que pase la fecha.
- **Desactivarla**: establece **Expiration mode** en **Allow expired** para ese país y tipo de documento en la [configuración de Verificación de identidad](https://docs.didit.me/es/core-technology/id-verification/overview.md). **Reject expired**, el modo por defecto, es el que realiza la monitorización. Un documento aceptado con **Allow expired** nunca se monitoriza.
- **Reverificación**: inicia una nueva sesión con el mismo `vendor_data` para actualizar los documentos.## Geolocalización de documentosLa comprobación de [geolocalización del documento de identidad](https://docs.didit.me/es/core-technology/id-verification/document-geolocation-id-verification.md) compara la ubicación de la dirección IP de quien envía el documento con el país emisor del documento de identidad. Los resultados se adjuntan a la decisión de la sesión.## Privacidad y retención- Todos los documentos se cifran en reposo.
- El acceso a las imágenes se realiza mediante URL firmadas de corta duración.
- La retención sigue la política de [retención de datos](https://docs.didit.me/es/console/data-retention.md) de la aplicación.
- Los usuarios tienen derecho a solicitar la eliminación; la eliminación borra las imágenes, los datos extraídos por OCR y los datos NFC.## Próximos pasos> [card] [Verificación de identidad](https://docs.didit.me/es/core-technology/id-verification/overview.md)
>
> Cómo funcionan la captura del documento de identidad y el OCR.> [card] [Prueba de domicilio](https://docs.didit.me/es/core-technology/proof-of-address/overview.md)
>
> Recopilación de documentos de prueba de domicilio.> [card] [Decisión de la sesión](https://docs.didit.me/es/sessions-api/retrieve-session.md)
>
> Referencia de GET /v3/session/{id}/decision/.


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