Saltar al contenido principal
GET
curl

Descripción general

Devuelve una única entidad de usuario identificada por vendor_data. Las respuestas incluyen didit_internal_id, el identificador interno estable de Didit.

Cuándo usarlo

  • Consulta del estado de verificación actual de un usuario: el mapa features te da el estado más reciente de cada función en un único objeto.
  • Vistas de detalle en tu propia interfaz: obtén el perfil bajo demanda antes de renderizarlo.
  • Puntuación de riesgo: combina los contadores de sesiones y features para puntuar a cada usuario por tu cuenta.

Notas

  • vendor_data en la URL distingue entre mayúsculas y minúsculas.
  • Devuelve 404 si no existe ningún usuario con ese vendor_data en la aplicación.
  • Los contadores agregados (session_count, approved_count, declined_count, in_review_count) se actualizan en tiempo real a medida que se completan las sesiones.
  • Consulta el modelo de datos de usuario para ver todos los campos.

Permisos

Cualquier clave de API activa de la aplicación puede invocar este endpoint. Las claves de API de Didit están asociadas a la aplicación, no al rol: los roles y permisos de la Console (read:users y el resto) deciden lo que una persona puede hacer en la Console, y no se evalúan para el tráfico de la Management API. Controla quién puede invocar este endpoint controlando quién puede leer la clave de API de la aplicación.

Relacionado

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 la sesión que dio de alta a este usuario por primera vez, y se compara exactamente tal como se envía.

Respuesta

Detalle completo del usuario, que incluye metadatos, registro de comentarios/actividad y datos agregados de sesiones.

Detalle completo del usuario. Amplía UserListItem con metadatos, comentarios y updated_at.

didit_internal_id
string<uuid>

UUID interno estable de Didit para este usuario.

vendor_data
string | null

Tu identificador único de este usuario (el que se envía al crear sesiones). Puede ser null si no se proporcionó ningún identificador propio.

display_name
string | null

Nombre visible personalizado que has definido

full_name
string | null

Nombre completo extraído de los documentos verificados

date_of_birth
string<date> | null
effective_name
string | null

Mejor nombre disponible: display_name si está definido; si no, full_name

status
enum<string>

Estado del ciclo de vida del registro del usuario (NO es un estado de sesión). ACTIVE es el valor predeterminado, FLAGGED marca al usuario para atención manual y BLOCKED impide nuevas sesiones para este vendor_data.

Opciones disponibles:
ACTIVE,
FLAGGED,
BLOCKED
portrait_image_url
string | null

URL prefirmada de la foto de retrato del usuario (caduca al cabo de unas horas)

session_count
integer

Número total de sesiones de verificación de este usuario

approved_count
integer

Número de sesiones aprobadas

declined_count
integer

Número de sesiones rechazadas

in_review_count
integer

Número de sesiones en revisión

issuing_states
string[]

Códigos ISO 3166-1 alpha-3 de los países emisores que figuran en los documentos de identidad aprobados de este usuario, p. ej., ["USA", "ESP"]. Array vacío si no hay ninguno.

approved_emails
string[]

Direcciones de correo electrónico verificadas obtenidas de las sesiones aprobadas de este usuario, p. ej., ["john@example.com"].

approved_phones
string[]

Números de teléfono verificados obtenidos de las sesiones aprobadas de este usuario, p. ej., ["+14155551234"].

features
object

Estado agregado por función de todas las sesiones de este usuario. Claves posibles: ID_VERIFICATION, NFC, LIVENESS, FACE_MATCH, POA, QUESTIONNAIRE, EMAIL_VERIFICATION, PHONE, AML, IP_ANALYSIS, AGE_ESTIMATION, DATABASE_VALIDATION. Valores posibles: Approved, Declined, In Review, Not Finished, Resub Requested.

features_list
object[]

Los mismos datos que features, como un array ordenado de objetos {feature, status}.

last_session_at
string<date-time> | null

Marca de tiempo de la sesión más reciente

first_session_at
string<date-time> | null

Marca de tiempo de la primera sesión

last_activity_at
string<date-time> | null

Marca de tiempo de la actividad más reciente de este usuario (sesión, transacción, cambio de estado, edición de datos, etc.).

tags
object[]

Asignaciones de etiquetas. NOTA: en las respuestas de detalle, cada entrada es un objeto de vínculo de etiqueta ({uuid, tag: {...}, added_by_email, added_by_name, created_at}), a diferencia de la forma plana {uuid, name, color} que se usa en las respuestas de listado.

created_at
string<date-time>
metadata
object

JSON de metadatos personalizados que adjuntaste a este usuario. Valor predeterminado: {}.

comments
object[]

Registro de actividad y comentarios de este usuario (cambios de estado, ediciones del perfil, notas manuales).

updated_at
string<date-time>
Última modificación el 1 de noviembre de 2026