Viewing and managing a customer's risk level
Last updated: November 9, 2026
Mesh scores each customer against the default risk model for its customer type, person or company. The score places the customer in one of the risk levels that model defines.
This article explains where the level is displayed, how to read the score behind it, when it changes, and how to set it manually.
Reading the risk level
Where the risk level is displayed
Customer page. A badge next to the customer's name, for example High risk.
Customers list. The Risk level column, also available as a filter.
Cases list. The Customer risk column, also available as a filter.
A risk model defines four levels: Low, Medium, High and Prohibited. The score range of each is set as described in Setting overall risk level thresholds.
The Risk section
The Risk section of the customer page shows how the level was reached.
Fields in the Risk section
Field | What it displays |
Overall risk level | The level the score falls into |
Overall risk score | The customer's total weighted score |
Calculated using | The risk model that produced the score, linked to it. Displayed to users whose role can view risk models |
Last calculated | How long ago the score was calculated |
Select Show breakdown to open the risk score breakdown by attribute. It lists each attribute in the risk model with the customer's value and its weighted score. How are risk scores calculated? explains the weighting.
When the risk level changes
What calculates or recalculates the score
Event | Effect on the score |
The customer is created, in the platform, through the API or by batch upload | Calculated with the default risk model for its customer type |
The customer's details are updated | Recalculated |
A customer onboarding or customer monitoring case is closed | Recalculated |
A user selects Calculate risk level using risk model | Recalculated with the current default risk model |
A risk model is activated, edited or set as default | Unchanged for existing customers until one of the other events recalculates their score |
Among screening decisions, only true positives affect the score, as explained in Taking screening hits into account when risk scoring. Updating customer information and Making a new risk model active cover the other events.
Setting the risk level manually
A manual level replaces the calculated score, and Mesh stops recalculating the customer automatically until the calculated score is restored. Setting a level or restoring the calculated score requires the Update customers permission; System roles and permissions explains how roles carry permissions.
On the customer page, select Actions, then Manage risk level.
Select Manually select risk level, then choose Low, Medium, High or Prohibited.
In Note, enter the reason for the change. The note is required and holds up to 1,000 characters.
Select Confirm.
The Risk section then displays the level and the note, and Calculated using displays Manual. The score and the breakdown are no longer displayed.
Restoring the calculated score
On the customer page, select Actions, then Manage risk level.
Select Calculate risk level using risk model.
In Note, enter the reason for the change. The note is required and holds up to 1,000 characters.
Select Confirm.
Mesh scores the customer against the current default risk model, using the latest customer data and the profiles marked as true positives. The Risk section then displays the calculated level, the score and the note, and Calculated using names the risk model.
Using the API
The risk level in the Mesh API
Endpoint or webhook | What it does |
Returns the overall level and score, the result for each category and attribute, and the risk model used | |
Sets the level manually with | |
| Notifies your systems when a customer's score changes |
| Notify your systems when a customer's level rises or falls |
Managing webhooks explains how to subscribe to webhook events.
Next steps
How are risk scores calculated? explains how the score is built from categories and weights. To change how scores are produced, see Creating a risk model.