{
  "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"
}

Qscore monitoring alert

A subject the account monitors via PUT /v1/qscore/subjects/{docID}/monitoring changed since the last check. triggers lists what fired the alert: score_drop_below (the score crossed the subscription’s monitor_since_score threshold downward: previous >= threshold, new < threshold), new_records (the bureau registered new events; with only_material: true only materially negative events — open delinquency, protest, bankruptcy, lawsuit — count) or records_removed (the bureau now shows fewer events than the baseline, i.e. a record was closed or deleted). Active subscriptions are re-checked every ~5 minutes; the first pass after subscribing only seeds the baseline and never alerts on the history the purchased report already showed. score and previous_score are omitted while the subject has no classifiable score, and new_records is omitted when no new event fired.

Every delivery includes X-Webhook-Event, X-Webhook-Event-ID, X-Webhook-Delivery-ID, X-Webhook-Timestamp and X-Webhook-Signature = hex(HMAC-SHA256(secret, timestamp + "." + body)). Respond 2xx; up to 5 attempts with incremental backoff.

WEBHOOK

risk_monitoring_alert

{
  "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"
}

Authorizations

Authorization

string

header

required

Session JWT (from register/login) or API key (pk_...). X-API-Key: <token> is accepted as an alternative header.

Body

application/json

monitoring_id

string

subject_id

string

doc_id

string

country

string

subject_type

enum<string>

Available options:

person,

company

triggers

enum<string>[]

Available options:

score_drop_below,

new_records,

records_removed

score

integer

previous_score

integer

band

enum<string>

Available options:

A,

B,

C,

D,

E,

SC

record_count

integer

new_records

object[]

Show child attributes

detected_at

string

Response

200

Return any 2xx to acknowledge the delivery.