Saltar al contenido principal
Esta página cubre solo las definiciones de campos. El orden en que leer la respuesta y cómo interpretarla están en leer resultados de análisis.

Endpoint

Petición

Parámetros de ruta

Estructura de la respuesta

Los campos de la respuesta se dividen en dos grupos.
Qué campos aparecen en extractedData lo decide el output schema del workflow. Omni no impone ninguna clave común. Lo que sí es fijo es que cada valor final va envuelto en el mismo sobre (value · reasoning · sourceStep).

Campos de nivel superior


confidence Analysis Score

La puntuación que aparece en la parte superior de la pantalla de detalle del análisis en el panel.

confidence.components

Cuando una parte es null, los pesos de las restantes se normalizan. Cuando las tres son null, score y level también son null.

details penalizaciones de la puntuación

Enumera cada elemento que bajó la puntuación confidence. Array vacío si no se penalizó nada. reasonCode es un enumerado ampliable. Los valores actuales y cómo leerlos están en leer resultados de análisis.

riskAssessment

Cómo se calcula riskScore

Se calcula solo a partir de los veredictos por acción. El contenido de los documentos y los resultados de extracción no intervienen.
La base es 25, así que riskScore nunca baja de 25. Cuando todas las acciones pasan, es exactamente 25 (low). El rango 0–25 de la tabla anterior es el límite del nivel; en la práctica no se dan valores de 0 a 24.
riskFactors lleva una línea {actionName} verification failed por cada acción fallida, más una única línea {count} action(s) need manual review cuando alguna acción requiere revisión.

systemMetadata

systemMetadata.outputFormatting

Bifurque según este status antes de leer extractedData. Cómo hacerlo está en leer resultados de análisis.

systemMetadata.workflowHistory

Contiene solo el trabajo que se ejecutó realmente. Las definiciones completas de los pasos están en workflowActions de GET /workflows/:workflowId.

systemMetadata.tokenUsage

tokenUsagePerWorkId usa los IDs de trabajo como claves y la estructura anterior como valores.

rawActionResults

Los resultados brutos, previos al ensamblado, que devolvieron las acciones. Las claves son nombres de acción, y qué acciones existen depende de la definición workflowActions del workflow.

rawActionResults mcpResults

Las mismas llamadas que agentAuditLog.steps[].mcpcalls[], organizadas por acción. Usa camelCase, como el nivel superior.

agentAuditLog

Un objeto con dos claves, steps y summary.
agentAuditLog es un objeto, no un array, y sus campos internos usan snake_case (work_id · executed_at · duration_ms). Eso difiere del camelCase de los campos de nivel superior.

agentAuditLog.steps

agentAuditLog.steps mcpcalls

agentAuditLog.summary


findings

result es agentAuditLog.steps[].status traducido para la interfaz (needs_review pasa a warning).

recommendations

targetItems


artifacts archivos generados

Los archivos que los motores generaron durante el análisis. El área Generated Files de la pestaña Info del panel muestra este array. Hoy los motores AML (AML Search - Person · AML - Business) generan un PDF de evidencia por cada coincidencia. Una consulta sin coincidencias no genera archivos, así que el array queda vacío. La descripción de una línea del panel (subject · threshold · date-of-birth basis · screening result · match count) se construye con estos campos. Si un campo falta, se omite su fragmento.
Obtener los PDF de evidencia no cambia los créditos: sigue siendo una llamada de consulta, sea cual sea el número de archivos — cómo se cobran los créditos.

verdict resultado de la consulta

Lo determina el nivel de riesgo de la parte coincidente. Los archivos de una misma consulta pueden diferir de una parte a otra.
artifacts[].verdict es el resultado de la consulta de un archivo. Es un valor distinto del verificationStatus de nivel superior, que es la decisión sobre todo el análisis. NO_HIT significa cero coincidencias, y cero coincidencias no generan archivo, así que casi nunca aparece. Forma parte del enumerado; contémplelo de todos modos.
Los análisis ejecutados antes del 2026-10-22 18:12 (KST) no guardaban un nivel de riesgo por coincidencia, así que todos los archivos de una consulta llevan el mismo valor, basado en el riesgo más alto de esa consulta. matchCount también se devuelve sin las coincidencias retiradas por fecha de nacimiento en los análisis antiguos.

Valores de dobMatching

El valor de coincidencia por fecha de nacimiento de las opciones fijadas en el paso. Solo AML Search - Person. Con cualquier valor distinto de off, las coincidencias sin fecha de nacimiento se retiran del resultado y su número queda en dobExcluded. off no usa la fecha de nacimiento, así que dobExcluded no aparece.

artifactOmissions

Una consulta genera archivos para las 50 coincidencias de mayor puntuación como máximo. Cada consulta con más de 50 coincidencias añade un elemento, que el aviso de límite del panel muestra.

artifactFailures

Cada consulta con archivos dentro del límite que no se pudieron obtener añade un elemento. Ante un error temporal, el servidor reintenta hasta 3 veces, dentro de 4 minutos por consulta, y deja aquí lo que aun así no pudo obtener. Los archivos no obtenidos no tienen fila en artifacts[]; si vuelve a ejecutar el análisis, se obtienen de nuevo.

Descargar un archivo generado

Haga GET sobre downloadUrl anteponiendo solo el host. downloadUrl ya empieza por /v1, así que anteponer la Base URL (…/v1) duplicaría /v1. Los números de la ruta son coordenadas internas: use el valor de la respuesta en lugar de construir la ruta.

Ejemplo

Una persona consultada con umbral 90 y fecha de nacimiento ±2 años. Tras retirar 9 coincidencias sin fecha de nacimiento quedaron 62; 1 archivo dentro del límite de 50 no se pudo obtener. artifacts muestra 2 de los 49 archivos obtenidos.

Ejemplo de respuesta

Una respuesta real es mucho más larga. El ejemplo siguiente incluye todas las claves de nivel superior pero muestra una sola entrada representativa por array y objeto anidado.

Resumen de enumerados

Códigos de error

Los errores comunes (400 validación · 401 autenticación · 403 permisos · 500 servidor) están en la descripción general de la API.