{
"monitoring_id": "7c9e2f14-5b6a-4c8d-9e1f-3a7b5c2d8e91",
"subject_id": "8f5fb0d2-1d45-4a0e-9d5c-2d39f2b7a112",
"doc_id": "12.345.678-5",
"country": "CL",
"subject_type": "person",
"triggers": [
"score_drop_below",
"new_records"
],
"score": 487,
"previous_score": 512,
"band": "D",
"record_count": 3,
"new_records": [
{
"source": "res_chile",
"record_type": "debt_collection",
"reported_at": "2026-08-05T00:00:00Z",
"amount": "450000",
"currency": "CLP",
"status": "open"
}
],
"detected_at": "2026-08-08T18:41:12Z"
}Alerta de monitoreo qscore
Un sujeto que la cuenta monitorea vía PUT /v1/qscore/subjects/{docID}/monitoring cambió desde la última revisión. triggers lista qué disparó la alerta: score_drop_below (el score cruzó hacia abajo el umbral monitor_since_score de la suscripción: anterior >= umbral, nuevo < umbral), new_records (el buró registró eventos nuevos; con only_material: true solo cuentan los eventos materialmente negativos — mora abierta, protesto, quiebra, demanda) o records_removed (el buró ahora muestra menos eventos que el baseline, es decir, un registro se cerró o se eliminó). Las suscripciones activas se re-evalúan cada ~5 minutos; la primera pasada tras suscribirse solo siembra el baseline y jamás alerta con el historial que ya mostraba el informe comprado. score y previous_score se omiten mientras el sujeto no tenga score clasificable, y new_records se omite cuando ningún evento nuevo disparó la alerta.
Cada entrega incluye X-Webhook-Event, X-Webhook-Event-ID, X-Webhook-Delivery-ID, X-Webhook-Timestamp y X-Webhook-Signature = hex(HMAC-SHA256(secret, timestamp + "." + body)). Responde 2xx; hasta 5 intentos con backoff incremental.
{
"monitoring_id": "7c9e2f14-5b6a-4c8d-9e1f-3a7b5c2d8e91",
"subject_id": "8f5fb0d2-1d45-4a0e-9d5c-2d39f2b7a112",
"doc_id": "12.345.678-5",
"country": "CL",
"subject_type": "person",
"triggers": [
"score_drop_below",
"new_records"
],
"score": 487,
"previous_score": 512,
"band": "D",
"record_count": 3,
"new_records": [
{
"source": "res_chile",
"record_type": "debt_collection",
"reported_at": "2026-08-05T00:00:00Z",
"amount": "450000",
"currency": "CLP",
"status": "open"
}
],
"detected_at": "2026-08-08T18:41:12Z"
}Autorizaciones
JWT de sesión (de register/login) o llave de API (pk_...).
X-API-Key: <token> se acepta como header alternativo.
Cuerpo
person, company score_drop_below, new_records, records_removed A, B, C, D, E, SC Show child attributes
Show child attributes
Respuesta
Devuelve cualquier 2xx para confirmar la entrega.