Investor

This page contains all relevant terminology regarding Investors.

Investor

Definition

See Investor.

Relevant endpoints

See Investor.

InvestorUser

Definition

Same as UserInvestorRole, but with a few more attributes such as ‘State’, ‘StartDate’ and ‘EndDate’ to keep track of user roles changing through time.

InvestorAccount

Definition

An InvestorAccount represents an investment account, in which money can be deposited to invest in Assets and from which money can withdrawn (e.g., after a payout). An Investor can have one or more InvestorAccounts. An InvestorAccount can be shared by multiple Investors. For example, a married couple can have an Account together.

Relevant endpoints

• POST /InvestmentAccounts
• POST /SearchInvestorAccounts
• GET /InvestmentAccountGetById/{labelId}/{investmentAccountId}
• GET /InvestorAccountsGetByInvestorId/{labelId}/{investorId}
• POST /InvestmentAccountNumbersByLabelId
• POST /v2/InvestorAccountAdd
• DELETE /InvestorAccountDeleteById/{labelId}/{investorId}
• PUT /v2/InvestorAccountUpdate
• GET /OrderFormDataGetByInvestorAccountId/{labelId}/{investorAccountId}

InvestorAccountGroup

Definition

For reporting purposes and commercial benefits, it is possible to group certain InvestorAccounts. Currently the only type of InvestorAccountGroup is ‘CoupledAccounts’.

Relevant endpoints

• GET /InvestorAccountGroups/{labelId}
• GET /InvestorAccountGroupGetById/{labelId}/{investorAccountGroupId}
• GET /InvestorAccountGroupsGetByInvestorAccountId/{labelId}/{investorAccountId}
• POST /InvestorAccountGroupAdd
• PUT /InvestorAccountGroupUpdate

Relation

Definition

For administrative purposes, it can be required to link the name of either an Employer or a Consultant to an InvestorAccount. For example, when an Employer creates a BOX1 InvestorAccount (see: ‘FiscalPolicy’) for their employee, this should be registered.

Relevant endpoints

• GET /Relations/{labelId}
• GET /RelationGetById/{labelId}/{relationId}
• POST /RelationAdd
• PUT /RelationUpdate

RiskClassification

Definition

For administrative purposes of the KYC and CDD (Customer Due Diligence) process, Users, Investors and InvestorAccounts are classified as ‘low risk’, ‘medium risk’ or ‘high risk’. This can depend on the their country of origin, among other things. For an IndividualHolder Investor, the RiskClassification is synced with the RiskClassification of the corresponding User with the ‘Owner’ UserInvestorRole. For a LegalEntity Investor, the RiskClassification is set individually.