Holder
A Holder is the Party that holds a Share or an Instrument on a Company’s cap table.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
party | Party | required | The person or entity behind the holding. |
Object
{
"$id": "https: //api.sb/ quietcopy.com/ holders/ holder_1",
"$type": "Holder",
"party": "party_1"
}Relationships
- A Holder has many Instruments: each Instrument belongs to one Holder, who sees it, its vesting and its documents.
instruments, inverseheldBy. - A Holder has many Shares: each Share record belongs to one Holder; a transfer writes a new record for the new Holder.
shares, inverseheldBy.
Verbs
createCreates a Holder.POST /{namespace}/holdersgetReturns one Holder by id.GET /{namespace}/holders/{id}listReturns Holders, newest first, one page at a time.GET /{namespace}/holdersupdateChanges the given properties of a Holder.PATCH /{namespace}/holders/{id}
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Holder.create | Yes | Yes | Yes | No |
Holder.get | Yes | Yes | Yes | Yes |
Holder.list | Yes | Yes | Yes | Yes |
Holder.update | Yes | Yes | Yes | No |
Call it
Add a holder to TutorLoop with a party.Example
A founder holds 4 million common Shares and an option Instrument in her Company. The cap table shows one Holder for her, with both holdings under it.