# Share

URL: /business/nouns/share · Id: `noun:share`

> A Share is a unit of ownership in a Company, of one class, held by one Holder.

A Share is a unit of ownership in a [Company](/business/nouns/company), of one class, held by one [Holder](/business/nouns/holder).

## Properties
| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `class` | `string` | Yes | The share class, such as common or preferred. |
| `quantity` | `integer` | Yes | How many units the record holds. |
| `price` | `money` | No | The price paid per unit at issue. |
| `issuedAt` | `datetime` | No | When the Company issued it. |
| `certificate` | [File](/business/nouns/file) | No | The certificate or book-entry File. |

## Object
```json
{
  "$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"
}
```

## Relationships
- <a id="rel-held-by"></a>A Share **is held by** one [Holder](/business/nouns/holder): each Share record belongs to one [Holder](/business/nouns/holder); a transfer writes a new record for the new Holder. `heldBy`, inverse [`shares`](/business/nouns/holder#rel-shares).
- <a id="rel-issued-by"></a>A Share **is issued by** one [Company](/business/nouns/company): a Share is issued by one [Company](/business/nouns/company) and sits on that Company’s cap table. `issuedBy`, inverse [`shares`](/business/nouns/company#rel-shares).

## Verbs
| Verb | Description | Subject | Event | Class |
| --- | --- | --- | --- | --- |
| [Share.issue](/business/nouns/share/issue) | Issue records new Shares of one class to a Holder under a board-approved Agreement, with the certificate or book entry. | [Legal Lead](/agents/legal/legal-lead) | [`Share.issued`](/business/events/Share.issued) | One-way (money): `send`, `do` |
| [Share.transfer](/business/nouns/share/transfer) | Transfer moves Shares from one Holder to another under a signed Agreement, within the Company’s transfer restrictions. | [Legal Lead](/agents/legal/legal-lead) | [`Share.transferred`](/business/events/Share.transferred) | One-way: `send`, `do` |
| <a id="get"></a>[Share.get](/business/nouns/share/get) | Returns one Share by id. Inherited from [Noun](/business/nouns/noun). | None. | None. | Read: `try`, `do` |
| <a id="list"></a>[Share.list](/business/nouns/share/list) | Returns Shares, newest first, one page at a time. Inherited from [Noun](/business/nouns/noun). | None. | None. | Read: `try`, `do` |

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

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

| Operation | `owner` | `admin` | `member` | `viewer` |
| --- | --- | --- | --- | --- |
| `Share.get` | Yes | Yes | Yes | Yes |
| `Share.list` | Yes | Yes | Yes | Yes |
| `Share.issue` | Yes | No | No | No |
| `Share.transfer` | Yes | No | No | No |

## Call it

**Ask**

```text
Issue the latest share with a holder and an agreement.
```

**API**

```bash
curl -X POST https://api.sb/kilnbakery.com/shares/issue \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"holder":"holder_1","class":"Example class","quantity":1,"price":{"amount":9,"currency":"USD"},"agreement":"agreement_1"}'
```

```json
{
  "api": "https://api.sb/kilnbakery.com",
  "share": {
    "$id": "https://api.sb/kilnbakery.com/shares/share_1",
    "$type": "Share",
    "class": "common",
    "quantity": 1
  },
  "action": {
    "$id": "https://api.sb/kilnbakery.com/actions/action_1",
    "operation": "Share.issue",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/kilnbakery.com/actions/action_1"
  }
}
```

**SDK**

```ts
import { $ } from 'startup-builder'

const share = await $.Share.issue({ holder: 'holder_1', class: 'Example class', quantity: 1, price: { amount: 9, currency: 'USD' }, agreement: 'agreement_1' })
```

**CLI**

```bash
npx startup-builder do Share.issue --json '{"holder":"holder_1","class":"Example class","quantity":1,"price":{"amount":9,"currency":"USD"},"agreement":"agreement_1"}'
```

**MCP**

```json
{
  "name": "do",
  "arguments": {
    "code": "return await $.Share.issue({ holder: 'holder_1', class: 'Example class', quantity: 1, price: { amount: 9, currency: 'USD' }, agreement: 'agreement_1' })"
  }
}
```

## Example
A [Company](/business/nouns/company) issues 1 million common Shares to a cofounder at $0.0001 each. The record carries the board-approved [Agreement](/business/nouns/agreement) and the book-entry certificate.