Skip to content
Connect API Catalog
/
Global Monitoring
/
Product Documentation
/
Special Event Rules
Last updated

Special Event Rules

This page provides guidance on setting up a collection of rules that can be applied to monitoring. Each rule includes specific parameters that allow you to customise notifications based on changes in credit scores, credit limits, company statuses, and other key metrics.

NOTE: This is not a complete list of the available rules, please see the two following endpoints:

  • All Event Rules
  • Filtered Event Rules (By Country Code)

Rules Requiring Extra Parameters

The following rules require additional parameters (Param 0, Param 1, Param 2) to configure notifications:

🌍 Global Rules

These rules apply globally and are not specific to any country.

Rule 101 – International Score Band Change (A–E)

This rule notifies you when a company's international score band (ranging from A to E) drops or changes based on specific thresholds.

ParameterDescription
param0(Optional) The number of score bands the rating must decrease by to trigger a notification. Values: "1", "2", "3", "4", or "". Leave empty ("") if you only want to use param1.
param1(Optional) A threshold band for any changes (up or down). Values: "A", "B", "C", "D", or "Any". If set to "Any", the rule monitors both upward and downward movements. If set to a specific band (e.g. "C"), it only monitors drops into or below that band — upward changes are ignored.
param2(Optional) If set to "true", the new band will be returned in both the API response and the notification email. If set to "false", the band will not be returned in the response.

Behavior Notes

  • Setting only param0 to "1" triggers a notification only when the score drops by 1 band (e.g., A → B, B → C).
  • If you set param0 to "2", you'll only be notified if the score drops by 2 or more bands (e.g., A → C, but not A → B).
  • To receive any score change, set param1 to "Any" — this overrides param0 and triggers on both increases and decreases.
  • If you only care about scores dropping below a certain threshold (e.g., band C), set param1 to "C" and leave param0 empty.
  • This rule only monitors decreases unless param1 is set to "Any".
  • There is no equivalent rule for increase-only monitoring.

Example Configurations

Goalparam0param1param2
Notify on any score change""Anytrue
Notify if band drops by 11""true
Notify if score drops below B""Bfalse
Notify if band drops by 2+2""true

Rule 102 - Credit Limit Value Change

ParameterDescription
param0 (boolean)When set to true, notifications are triggered for any change in the credit limit, regardless of amount or direction (up or down). When set to false or omitted, notifications only trigger based on the thresholds defined by param1 and param2.
param1 (number)The percentage decrease threshold for the credit limit. A notification is triggered when the credit limit reduces by this percentage or more.
This only applies to downward changes (reductions).
param2 (number)The credit limit value threshold. Notifications trigger when the credit limit falls below this value.
This is an absolute threshold, not a change percentage.

How the parameters work together:

  • If param0 is true, the rule ignores param1 and param2 and sends notifications on any credit limit change (up or down).
  • If param0 is false or missing, the rule sends notifications only when the credit limit falls by at least param1 percent downwards, or falls below the absolute value set by param2.
  • There is no "up only" or "up and down" option unless param0 is set to true.
  • This means you can either:
    • Monitor any change (param0=true), or
    • Monitor downward changes and thresholds (param0=false + param1/param2).

Examples:

param0param1param2Behavior
true101000Notify on any credit limit change.
false101000Notify only if credit limit drops by 10% or below 1000.
false20500Notify only if credit limit drops by 20% or below 500.
false(none)(none)Rule will not generate any notifications.

Country-Specific Rules

These rules are specific to certain countries, as indicated by their abbreviations (e.g., US, DE, FI, NL).

Belgium (BE)

Rule 1703 - BE - Credit Score

  • Param 0: Enter a percentage value indicating the drop in credit score that will trigger a notification.
    For example, if the score decreases by 20%, you will receive a notification.

Germany (DE)

Rule 2000 - DE - Credit Limit

  • Param 0: Enter a percentage value indicating the change in the credit limit of a DE-registered company that will trigger a notification.
    For example, if the credit limit increases or decreases by 20%, you will be notified.

Rule 2001 - DE - International Credit Score

  • Param 0: Enter a percentage value indicating the change in the credit score of a DE-registered company that will trigger a notification.
    For example, if the credit score increases or decreases by 20%, you will be notified.

Rule 2009 - DE - Non-Reg Credit Limit

  • Param 0: Enter a percentage value indicating the change in the credit limit of a DE non-registered company that will trigger a notification.
    For example, if the credit limit increases or decreases by 20%, you will be notified.

Rule 2010 - DE - Non-Reg Credit Score

  • Param 0: Enter a percentage value indicating the change in the credit score of a DE non-registered company that will trigger a notification.
    For example, if the credit score increases or decreases by 20%, you will be notified.

Finland (FI)

Rule 801 - FI Local Rating Score Change

  • Param 0: Enter a numeric value indicating the amount by which the rating score must increase or decrease to trigger a notification.
    For example, if Param 0 = 20, you will be notified if the rating score increases by at least 20 or decreases by 20 or more.

Netherlands (NL)

Rule 1503 - NL - Credit Score

  • Param 0: Enter a percentage value indicating the drop in credit score that will trigger a notification.
    For example, if the score decreases by 20%, you will receive a notification.

Norway (NO)

Rule 901 - NO Local Rating Score Change

  • Param 0: Enter a numeric value indicating the amount by which the rating score must increase or decrease to trigger a notification.
    For example, if Param 0 = 20, you will be notified if the rating score increases by at least 20 or decreases by 20 or more.

Spain (ES)

Rule 2201 - ES - New Accounts Field

This rule monitors event changes and does not require additional parameters.

  • Set the "isActive" parameter to 1 to enable notifications for these events.

Rule 2202 - ES - Company Status

This rule monitors event changes and does not require additional parameters.

  • Set the "isActive" parameter to 1 to enable notifications for these events.

Rule 2203 - ES - Judicial Event

This rule monitors event changes and does not require additional parameters.

  • Set the "isActive" parameter to 1 to enable notifications for these events.

United States (US)

Rule 1601 - US - Rating Change (Increases or Decreases)

  • Param 0: Enter a percentage value indicating the minimum percentage by which a rating must change to trigger a notification.
  • Param 1: Enter a value indicating the minimum increase or decrease in the rating score to trigger a notification.
    For example, if the rating increases or decreases by 10% or the value change is greater than 20, you will receive a notification.

Rule 1604 - US - DBT (Days Beyond Terms) Change

This rule is similar to Rule 1601, but instead of monitoring rating changes, it monitors changes in the value of DBT (Days Beyond Terms).

Rule 1606 - US - Derogatory Filing Count

  • Param 0: Enter a percentage value indicating the increase or decrease in the filing count that will trigger a notification.
  • Param 1: Enter a value indicating the minimum change (increase or decrease) in the filing count that will trigger a notification.
    For example, you can set it to get notified if the change is greater than 10% or exceeds 20.

Rule 1607 - US - Derogatory Filing Outstanding Amount

  • Param 0: Enter a percentage value indicating the increase or decrease in the outstanding amount that will trigger a notification.
  • Param 1: Enter a value indicating the minimum change (increase or decrease) in the outstanding amount that will trigger a notification.
    Use this parameter in the same way as Rule 1606.

Notes

These rules provide flexibility to monitor various changes in credit scores, credit limits, company statuses, and other metrics. Customize the parameters as needed to align with your business requirements.

Previous page
Next page