Saltar al contenido principal
GET
curl

Descripción general

Devuelve un trabajo de monitorización continua de AML iniciado desde Activar o desactivar la monitorización AML de usuarios o Activar o desactivar la monitorización AML de empresas: su estado, los contadores por resultado y una entrada en results por cada usuario o empresa procesados. Las selecciones de más de 20 perfiles se ejecutan en segundo plano, y la llamada de activación devuelve 202 con un trabajo en estado PENDING. Consulta este endpoint cada pocos segundos hasta que status sea COMPLETED o FAILED. results se va completando a medida que se procesan los perfiles, en el orden de procesamiento, y queda completo cuando el trabajo está en COMPLETED. Los resultados por registro se guardan para los trabajos iniciados a través de la API; un trabajo iniciado desde la Business Console solo muestra los contadores.

Estado del trabajo

Los valores de outcome por registro están documentados en las páginas de activación.

Permisos

Cualquier clave de API activa de la aplicación puede invocar este endpoint. Un trabajo solo es visible para la aplicación que lo creó; cualquier otro job_id devuelve 404.

Contenido 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

job_id
string<uuid>
requerido

El job_id que devuelve el endpoint de activación.

Respuesta

El trabajo.

job_id
string<uuid>
status
enum<string>
Opciones disponibles:
PENDING,
PROCESSING,
COMPLETED,
FAILED
is_enabled
boolean

true cuando el trabajo activa la monitorización, false cuando la desactiva.

target_type
enum<string>

Qué familia de perfiles activa o desactiva el trabajo.

Opciones disponibles:
user,
business
total
integer

Perfiles que procesa el trabajo.

processed
integer

Perfiles procesados hasta el momento.

outcomes
object

Contadores de resultados por registro. Cada perfil seleccionado corresponde exactamente a un contador; no se omite nada de forma silenciosa.

results
object[]

Una entrada por perfil procesado, en orden de procesamiento. Crece mientras se ejecuta el trabajo; está completa cuando el estado es COMPLETED. Se registra para los trabajos iniciados a través de la API; un trabajo iniciado desde la Business Console solo informa contadores.

error
string | null

Mensaje de error genérico cuando el estado es FAILED; la causa detallada se conserva en la plataforma.

created_at
string<date-time>
completed_at
string<date-time> | null
Última modificación el 1 de noviembre de 2026