Company, Security and Security Operation
These three concepts model the product side of the platform — the financial instruments that investors subscribe to and the corporate events that affect them.
Company
A Company is the legal entity that issues a financial product. It is sometimes called the Issuer. A company has a type (CompanyType) that distinguishes between, for example, a private equity vehicle, or a target company.
Key attributes of a Company:
- Corporate name and registered address
- Legal status (SAS, SA, SARL, etc.)
- Representatives (natural persons)
Security
A Security is a financial instrument — typically a share class of a fund or a unit in a real estate vehicle — issued by a Company. Investors subscribe to Securities through their Accounts.
Key attributes of a Security:
| Attribute | Description |
|---|---|
| Name | The name of the security, might be commercial or legal name |
securityType | Type of instrument |
| Fee patterns | The fee structures applicable to this security |
query {
GetSecurities {
id
type {
code
label
}
name
stakes {
id
stakerName
}
# ...Other Security fields
}
}
→ Type reference: Security
Security Operation
A Security Operation is a planned corporate event that applies uniformly to a group of existing holders of a given Security. It is the mechanism through which the issuer manages investment and post-investment lifecycle events.
Types of Security Operations
| Type | Description |
|---|---|
| Investment | New subscription round opened to investors |
| Distribution | A cash or dividend payment to holders |
| Capital Call | A call for additional capital from holders who subscribed in tranches |
| Cession | A sales-back of securities to the vehicle |
Each Security Operation has:
- A status (
SecurityOperationStatus):open→closed - An associated Security
- A set of individual transactions linked to each eligible Account
Security Operation Workflow
Example: Fetching Open Security Operations
query {
GetSecurityOperations(
securityOperationTypes: [Investment, CapitalCall]
) {
id
name
securityOperationStatus {
code
label
}
# ...Other SecurityOperation fields
}
}
→ Type reference: SecurityOperation
Related Queries & Mutations
| Operation | Reference |
|---|---|
| List all securities | GetSecurities |
| Fetch a single security | GetSecurity |
| List all security operations | GetSecurityOperations |
| Fetch a single security operation | GetSecurityOperation |
| Open a security operation | OpenSecurityOperation |
| Close a security operation | CloseSecurityOperation |