Skip to content
StartupBuilderby Startups.Studio
Business
Changelog
Events

Instrument.granted

Emitted each time an Instrument is granted.

Instrument.grant emits Instrument.granted when it completes on an Instrument.

PropertyValue
Emitted byInstrument.grant
NounInstrument
WakesNone.

Payload

Each delivery is an Event record. data holds what Instrument.grant returns.

FieldTypeRequiredDescription
namestringrequiredInstrument.granted.
atdatetimerequiredWhen it happened.
seqintegerIts position in the namespace, one more than the Event before; any seq is a cursor into the history.
datajsonrequiredThe Thing as the Action left it.
data.instrumentInstrumentrequiredThe granted option.
data.instrument.kindstringrequiredWhich right: safe, note, option or warrant.
data.instrument.amountmoneyThe amount invested, for a SAFE or a note.
data.instrument.capmoneyThe valuation cap a SAFE or note converts at.
data.instrument.discountnumberThe percent discount to the next priced round a SAFE or note converts at.
data.instrument.strikemoneyThe price per Share an option or warrant exercises at.
data.instrument.quantityintegerThe Shares an option or warrant covers.
data.instrument.vestingjsonThe vesting schedule and cliff of an option grant.
data.instrument.statusstringrequiredWhere it stands; a canceled or converted Instrument is kept, never deleted.

Example

JSON
{
  "$id": "https://api.sb/patentpad.com/events/event_1",
  "$type": "Event",
  "name": "Instrument.granted",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "instrument": {
      "$id": "https://api.sb/patentpad.com/instruments/instrument_1",
      "$type": "Instrument",
      "kind": "safe",
      "amount": {
        "amount": 499,
        "currency": "USD"
      },
      "cap": {
        "amount": 499,
        "currency": "USD"
      },
      "discount": 1,
      "strike": {
        "amount": 499,
        "currency": "USD"
      },
      "quantity": 1,
      "vesting": {},
      "status": "outstanding"
    }
  },
  "seq": 1
}