Shares
Share records, transfer restrictions, acquisition types, and holding period rules.
After a subscription is approved and shares are issued, investors hold share records representing their ownership of securities. Shares track units owned, cost basis, acquisition details, and any transfer restrictions.
All endpoints are under the /issuance prefix and require a Rialto access_token (Bearer).
Listing Shares
curl "https://api.rialto.com/issuance/shares?status=active" \
-H "Authorization: Bearer <rialto_access_token>"Query Parameters:
| Parameter | Type | Description |
|---|---|---|
security_class_id | UUID | Filter by security class |
offering_id | UUID | Filter by offering |
status | string | Filter: active, transferred, converted, redeemed, cancelled |
restricted | boolean | Filter by transfer restriction |
| Pagination | -- | page, limit, sort_by, sort_order |
Response:
{
"success": true,
"data": [
{
"id": "f6a7b8c9-...",
"security_class_id": "d4e5f6a7-...",
"units": 1000,
"price_per_unit": "10.00",
"total_cost_basis": "10000.00",
"currency": "USD",
"acquisition_type": "primary",
"acquisition_date": "2026-03-20T00:00:00.000Z",
"holding_period_end_date": "2027-03-20T00:00:00.000Z",
"restricted": true,
"restricted_until": "2027-03-20T00:00:00.000Z",
"status": "active",
"created_at": "2026-03-20T00:00:00.000Z",
"updated_at": "2026-03-20T00:00:00.000Z",
"security": {
"id": "d4e5f6a7-...",
"name": "Class A Common Stock",
"category": "equity"
},
"offering": {
"id": "a1b2c3d4-...",
"name": "Series A Preferred Stock Offering"
}
}
],
"meta": {
"page": 1,
"limit": 20,
"total": 3,
"total_pages": 1,
"has_next_page": false,
"has_previous_page": false
}
}Getting Share Details
curl https://api.rialto.com/issuance/shares/<shares_id> \
-H "Authorization: Bearer <rialto_access_token>"Returns the same fields as the list item above.
Share Fields
| Field | Type | Description |
|---|---|---|
id | UUID | Unique share record ID |
security_class_id | UUID | The security class these shares belong to |
units | number | Number of units held |
price_per_unit | string | Price paid per unit |
total_cost_basis | string | Total amount paid (units x price) |
currency | string | Currency (USD) |
acquisition_type | string | How the shares were acquired |
acquisition_date | ISO 8601 | Date shares were issued |
holding_period_end_date | ISO 8601 or null | When the holding period ends |
restricted | boolean | Whether transfers are restricted |
restricted_until | ISO 8601 or null | Date restriction lifts |
status | string | Current status of the shares |
security | object or null | Related security class info |
offering | object or null | Related offering info |
Share Statuses
| Status | Description |
|---|---|
active | Currently held by the investor |
transferred | Transferred to another party |
converted | Converted to a different security (e.g., convertible note to equity) |
redeemed | Redeemed by the issuer |
cancelled | Cancelled by admin |
Acquisition Types
| Type | Description |
|---|---|
primary | Acquired through primary offering subscription |
secondary | Acquired through secondary market transfer |
conversion | Acquired through security conversion |
exercise | Acquired through warrant/option exercise |
dividend | Acquired as stock dividend |
stock_split | Acquired through stock split |
gift | Received as gift |
inheritance | Received through inheritance |
other | Other acquisition method |
Transfer Restrictions
Many securities issued through private offerings have transfer restrictions:
- Restricted shares (
restricted: true) cannot be freely transferred - The holding period (
holding_period_end_date) indicates when restrictions may lift - Holding period rules follow SEC regulations:
rule_144-- Rule 144 holding period (typically 6 months or 1 year)reg_s-- Regulation S restrictions for offshore transactionsnone-- No holding period rule applies
Shares Event
| Event | When it fires |
|---|---|
shares.issued | New shares issued from a completed subscription |
Subscribe via webhooks to receive this event.