Risk Rating Entities

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude

Using BNDRY, you can assign a Low, Medium, High, or Critical Risk Rating to entities automatically or manually. The Risk Rating property on an entity can be selected by a user manually, or it can be assigned through rules.

BNDRY is integrated with Hawk, a third-party SaaS that provides transaction monitoring and customer risk scoring capability. By leveraging the Hawk integration in BNDRY, you can configure a customer risk scoring Activity that automatically assigns a risk rating of Low, Medium, High, or Critical based on rules that you define.

The Risk Rating calculation is dynamic, and can respond to changes to Entity details and behaviour.

What You Can Do

BNDY can assign a risk score based on Entity Detail and Entity Activity factors. Entity Details that you can use to calculate a risk rating include:

• Date of Birth
• Place of Birth
• Nationality
• Country of Residence
• Occupation
• ID Issuing Country

Activity Details that you can use to calculate a risk rating include:

• PEP/Sanctions Screening Score
• Adverse Media Screening Score
• ID Verification Score
• Number of SMRs filed

If required, we can work with you to map in additional and custom Entity Details into the risk calculation model. Get in touch with our team to enable automated Risk Rating for your organisation.

You can run the Automated Entity Risk Rating Activity through the BNDRY UI, APIs, or by configuring policies to automate checks.

Prerequisites

The Entity Risk Rating Activity must be performed against an entity, and can run against both business and individual entities, depending on what rules have been configured. You can create Entities:

Check out our Entities API for more details.

Triggering Entity Risk Rating from the UI

1. Navigate to the entity's profile.
2. Open the Actions menu.
3. Select Entity Risk Rating.

Results are recorded against the entity's profile as Activity Logs for audit and reporting purposes.

Triggering Entity Risk Rating through policies

You can configure Policies to automatically trigger Verification and Screening:

• Scheduled Checks: configure schedules to calculate Entity Risk Rating periodically. For example: re-calculate an Entity Risk Rating every year.
• Conditional Checks: configure policies to run Entity Risk Rating when certain conditions are met. For example: calculate Entity Risk Rating whenever a new SMR is submitted against the Entity.

Get in touch with our team if you need help configuring Policies for your organisation.

Calculate Entity Risk Rating Activity through the API

Entity Risk Rating, like all BNDRY Activities, is available through the API. Trigger the Entity Risk Rating for an entity through the entity's URL path, specifying the entity resource name, and the name of the Job.

Running an Entity Risk Rating Job returns an ID which you can use to query the instance of the job and obtain the Entity Risk Rating result. Job runs are an asynchronous process, so the result must be queried for after the job is run.

Run the Entity Risk Rating Job

Submit a POST request to initiate the Entity Risk Rating Job.

curl -i -X POST \
  'https://api.bndry.app/v1alpha/entities/-/individualEntityRiskRatingJobs/{individualEntityRiskRatingJob}:run' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

BNDRY returns a response containing a reference to the instance of the job run.

{
    "name": "entities/4dbaefc7-2866-4ab2-a5b1-560116c06bf3/IndividualEntityRiskRatingJob/my-new-rr-job/operations/4f61bfab-def3-426f-9c1f-77032c8eb551",
    "metadata": {
        "@type": "type.googleapis.com/bndry.api.risk.entities.v1alpha.RunIndividualEntityRiskRatingJobMetadata"
    },
    "done": false
}

Query the Entity Risk Rating Job Instance

Submit a GET request to retrieve the results of the Entity Risk Rating Job.

curl -i -X GET \
  'https://api.bndry.app/v1alpha/entities/-/individualEntityRiskRatingJobs/{individualEntityRiskRatingJob}/operations/op_abc123' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

BNDRY returns the results of Entity Risk Rating.

{
  "name": "string",
  "metadata": {
    "type": "string",
    "value": "string"
  },
  "done": true,
  "error": {
    "code": 0,
    "message": "string",
    "details": [
      {
        "type": "string",
        "value": "string"
      }
    ]
  }
}