Roaring logo
Log in

Company Engagements

Displays all companies a person has board assignments in.

Company Engagements

[se]
Webhook is availableHistorical data available

Documentation

The Company Engagements API provides detailed insights into an individual’s involvement across different companies. It identifies their roles, such as CEO, board member, auditor, or external signatory, and displays a complete list of the companies they are engaged with. This data is valuable for understanding an individual’s professional reach, governance roles, and potential conflicts of interest. It supports organizations in assessing risks, ensuring compliance with regulations, and mitigating reputational harm.

Key Features:

  • Access a list of companies associated with an individual.
  • Identify the roles an individual holds, including board member, CEO, or auditor.
  • Streamline customer onboarding and enhance the quality of customer data.
  • Ensure compliance by verifying roles for AML/KYC checks.

Use case:

  • A bank is onboarding a new B2B client. To ensure the individual representing the company is not involved with any high-risk entities, the bank uses the Company Engagements API to check the individual's directorships and board positions across other companies.

  • A municipality uses the company engagement API to track all board or executive roles of individuals affiliated with potential vendors. This helps uncover cross-company ties that could signal conflicts of interest in the procurement process.

Role Codes

Below is a list of available Role codes for roles that persons can have in a company. The information is displayed as a code with a descriptive text.

Code
Role (Sv)
Role
0InnehavareHolder
1ArbetstagarrepresentantEmployee representatives
2Extern firmatecknareExternal signatory
3Extern verkställande direktörExternal CEO
4Extern vice verkställande direktörExternal Deputy CEO
5LedamotCommissioner
6LikvidatorReceiver in liquidation liquidator
7LikvidatorssuppleantAlternate Deputy Liquidator
8RevisorAuditor
9RevisorssuppleantDeputy Auditor

Rows per page

Page 1 of 4

Endpoints

Fetch engagements for person

gethttps://api.roaring.io/se/company/engagement/3.0/{personalNumber}

Parameters path

personalNumber

required

string
Person identification

Parameters query

asOfDate
string
Date on format yyyy-mm-dd
includeWithRoleCode
array
Include engagements with roleCodes
excludeWithRoleCode
array
Exclude engagements with roleCodes
includeRoleCode
array
Include roles with roleCodes
excludeRoleCode
array
Exclude roles with roleCodes

Response schema: application/json

  • changeDate

    string

    No description provided.

  • firstName

    string

    No description provided.

  • fullName

    string

    No description provided.

  • hitCount

    integer <int32>

    No description provided.

  • personalNumber

    string

    No description provided.

  • surName

    string

    No description provided.

Find history engagements by personal number

gethttps://api.roaring.io/se/company/engagement/3.0/history/{personalNumber}

Parameters path

personalNumber

required

string
Number of person

Parameters query

fromDate
string
beginning of the date range (including), iso 8601 format
toDate
string
ending of the date range (excluding), iso 8601 format