Risk indicators

Documentation

This API offers valuable data for assessing whether to engage in business with a company. Its strength lies in the ability to define custom templates with sets of rules that influence the API's response. These rules act as alarm thresholds, triggering a true/false alarm state. When configured correctly, each indicator will display an alarm status, providing a comprehensive view of the company's risk level.

Entities in the API:

• Indicators: Actual data points representing company events, including historical data.
• Templates: User-defined configurations of rules applied to indicator data.
• Rules: Definitions with user-defined parameters that build the conditions to filter indicator data.

Customize Your Experience with Risk API Templates:

To query the Risk API, a user-defined template is required. This template can be created in the "Risk Templates" section, accessible via the admin panel. During the creation process, users select one of the predefined templates and configure it with custom parameters and thresholds. Once saved, the templates for your organization will appear in the list at the root of the "Risk Templates" section. Each template is assigned a templateId, which is then used to query the API through the GET /{templateId}/{companyId} endpoint. This applies the template to the indicator data for the specified company.

Within the "Risk Templates" section, users can create, list, and modify existing templates. Additionally, a changelog is available to help users easily track changes made to templates within their organization.

Primary Endpoint:

After obtaining a templateId a user can now query the API via GET /{templateId}/{companyId} endpoint. This will applying the template to the indicator data of the specified company.

Helper Endpoints: These endpoints complement the UI-based approach to managing templates. The write endpoint have been disabled initially but its possible to list entities via the API.

• Retrieve Templates: Use GET /templates to view the templates associated with your company. If no templates are available, you can add /templates?showDefault=True to display public or global templates. These templates can be used immediately, but creating customized versions is recommended for more relevant insights.
• Retrieve Specific Template By Id: The /template/{templateId} to fetch specific template with given templateId

Indicators and default values

Below is a table of indicators that are recalculated on a daily basis. Some indicators might not be available for certain companies. As example:

• revenueByEmployee indicator is missing for a company without employees
• missingAuditor flag is missing for non-AB company.
• meanAgeOfRepresentatives is missing if there is no board For these indicators the rule will not be evaluated at all (they will be omitted from the API response)

The sandbox examples consist of 1 companies with mocked indicator data and 1 pre-configured templates. In a production environment, the indicators are recalculated daily based on real company data, while the templates can be adjusted at any time through the settings GUI. The parameter values in these sandbox templates are purely fictional and not recommendations for production use. In production, customers should define thresholds that suit their specific needs. For advice on configuring templates, don’t hesitate to contact Roaring support.

1. Full Sandbox Template (0eeddfb5-7ff2-48d0-ba5f-7e36d9ea040a)

The full sandbox template is designed to identify a broad range of risks effectively. It includes balanced thresholds and active monitoring of key indicators such as board changes, revenue efficiency, and regulatory compliance. The template aims to catch companies with operational instability, financial issues, or regulatory non-compliance.

Key Characteristics:

• Balanced thresholds for indicators like board changes, address changes, and financial performance.
• Comprehensive coverage: Monitors both financial and non-financial risks, including compliance with tax and registration regulations.
• Multi-dimensional risk detection, ensuring companies with various risk profiles are identified.