Share

PropertiesCopy Anchor Link

ObjectCopy Anchor Link

{
  "$id": "https://api.sb/patentpad.com/shares/share_1",
  "$type": "Share",
  "class": "common",
  "quantity": 1,
  "price": {
    "amount": 499,
    "currency": "USD"
  },
  "issuedAt": "2026-10-22T12:00:00Z",
  "certificate": "file_1"
}

RelationshipsCopy Anchor Link

• A Share is held by one Holder: each Share record belongs to one Holder; a transfer writes a new record for the new Holder. heldBy, inverse shares.
• A Share is issued by one Company: a Share is issued by one Company and sits on that Company’s cap table. issuedBy, inverse shares.

VerbsCopy Anchor Link

1. getReturns one Share by id.
   GET /{namespace}/shares/{id}readNo Event
2. listReturns Shares, newest first, one page at a time.
   GET /{namespace}/sharesreadNo Event
3. issueIssue records new Shares of one class to a Holder under a board-approved Agreement, with the certificate or book entry.
   POST /{namespace}/shares/issuedoShare.issued
4. transferTransfer moves Shares from one Holder to another under a signed Agreement, within the Company’s transfer restrictions.
   POST /{namespace}/shares/{share}/transferdoShare.transferred

A Share is kept forever and never edited: it has no update or delete.

PermissionsCopy Anchor Link

Which Access level may call each Verb. One-way Verbs wait their delay window.

Call itCopy Anchor Link

Issue the latest share with a holder and an agreement.

ExampleCopy Anchor Link

A Company issues 1 million common Shares to a cofounder at $0.0001 each. The record carries the board-approved Agreement and the book-entry certificate.