Saltar al contenido principal
GET
cURL

Descripción general

Devuelve un único PDF con el historial completo de verificaciones de una entidad de usuario, identificada por vendor_data. Es el mismo documento que genera la Console desde User detail → Actions → Download PDF, para que los equipos de cumplimiento automaticen las exportaciones en lugar de hacer clic una vez por cada usuario. El informe contiene:
  • Una portada con el resumen del perfil (nombre, fecha de nacimiento, estados emisores, correos electrónicos y teléfonos aprobados), el último estado de cada función, los contadores de sesiones y un índice de las sesiones incluidas.
  • Un informe de sesión completo por cada sesión incluida, en orden cronológico (de la más antigua a la más reciente). Cada uno es el mismo informe que Generar PDF devuelve para esa sesión por separado.

Sesiones elegibles y límite

Solo se incluyen las sesiones de Verificación de usuarios (KYC) en estado Approved, Declined, In Review o Kyc Expired. Las sesiones en cualquier otro estado (Not Started, In Progress, Abandoned, Expired, …) se omiten. El informe se limita a las 20 sesiones más recientes que se pueden incluir. Cuando un usuario tiene más, se incluyen las 20 más recientes y la portada indica cuántas sesiones más antiguas quedaron fuera. Usa Listar sesiones filtrando por vendor_data cuando necesites la lista completa en JSON.

Respuesta

El cuerpo es el propio PDF (application/pdf), no un envoltorio JSON ni una URL de descarga. El encabezado Content-Disposition es attachment; filename=user_<didit_internal_id>.pdf, donde didit_internal_id es el identificador estable del usuario en Didit.

Marca blanca

Cuando la personalización de marca blanca está activada en tu aplicación, la portada y cada informe de sesión llevan tu logotipo y la URL de tu política de privacidad en lugar de la marca Didit, igual que con el endpoint por sesión. Configúrala en Console → Customization.

Caché y latencia

No se almacena nada en caché: cada llamada vuelve a generar el informe a partir de los datos actuales, de modo que un informe solicitado después de una revisión manual refleja la decisión del revisor. Dos llamadas pueden producir archivos que difieran byte a byte; archiva el archivo descargado cuando necesites una copia inmutable. La generación es síncrona y descarga todas las imágenes almacenadas de cada sesión incluida, por lo que la generación del informe de un usuario con muchas sesiones con abundante contenido multimedia puede tardar decenas de segundos. Usa un tiempo de espera de lectura amplio en el cliente (se recomiendan 120 s) y transmite el cuerpo a disco. La generación se detiene al alcanzar un límite de tiempo en el servidor en lugar de continuar hasta que tu cliente se rinda: si se alcanza ese límite, el informe devuelve igualmente un PDF válido con las sesiones más recientes y la portada indica cuántas se omitieron.

Barra final

La ruta canónica termina con una barra final (…/generate-pdf/). Una solicitud sin ella se atiende directamente con la misma respuesta: no hay redirección 301, así que ningún cliente tiene que seguir redirecciones y curl no necesita -L. Usa la URL con barra final como en los ejemplos; es la forma que muestran la especificación OpenAPI y tus registros.

Errores

Ejemplos

Permisos

Cualquier clave de API activa de la aplicación puede llamar a este endpoint. Las claves de API de Didit tienen alcance de aplicación, no de rol: los roles y permisos de la Console (read:users y los demás) determinan lo que una persona puede hacer en la Console, y no se tienen en cuenta para las solicitudes a la Management API. Una clave solo puede exportar usuarios de su propia aplicación.

Páginas relacionadas

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

vendor_data
string
requerido

Tu identificador único del usuario: una cadena de texto libre (NO un UUID). Es el mismo valor que enviaste como vendor_data al crear las sesiones del usuario, y se compara exactamente tal como se envía. Codifícalo para URL; un valor que contenga / no se puede usar con esta ruta.

Respuesta

El documento PDF generado, devuelto directamente como binario application/pdf: no hay envoltorio JSON ni redirección a una URL de descarga. El cuerpo empieza con los bytes mágicos %PDF. Guárdalo en un archivo .pdf o transmítelo directamente a quien hizo la llamada.

The response is of type file.

Última modificación el 1 de noviembre de 2026