Skip to content

Option Grant

An option grant is a contract that gives an employee the right to purchase a company's stock at a set price.

OCF Equivalent

Maps to OCF's EquityCompensationIssuance (the successor to PlanSecurityIssuance in newer OCF versions). Both represent issuing options from a stock plan to a holder.

Related:

  • PlanSecurityIssuance — issuance tx. Predecessor schema retained for backward compatibility.
  • StockPlan — object. The plan the grant draws from.
  • VestingTerms — object. Carta's grant carries its vesting schedule inline; OCF links to shared VestingTerms.

Endpoints

  • GET /v1alpha1/issuers/{issuerId}/optionGrants — list
  • GET /v1alpha1/issuers/{issuerId}/optionGrants/{id} — single

Shape at a glance

Quick comparison of field names, types, and required-ness. See the full Carta properties below, or follow the OCF link for full OCF field documentation.

Carta — v1alpha1OptionGrant

An option grant is a contract that gives an employee the right to purchase a company's stock at a set price.

Property Type Req
id string
issuerId string
stakeholderId string
equityIncentivePlanName string
issueDate v1alpha1Iso8601CompleteCalendarDate
vestingStartDate v1alpha1Iso8601CompleteCalendarDate
boardApprovalDate v1alpha1Iso8601CompleteCalendarDate
stakeholderAcceptanceDate v1alpha1Iso8601CompleteCalendarDate
canceledDate v1alpha1Iso8601CompleteCalendarDate
grantExpirationDate v1alpha1Iso8601CompleteCalendarDate
lastExercisableDate v1alpha1Iso8601CompleteCalendarDate
disqualificationDate v1alpha1Iso8601CompleteCalendarDate
isoNsoSplit boolean
stockOptionType issuerssecuritiesv1alpha1StockOptionType
quantity v1alpha1Decimal
outstandingQuantity v1alpha1Decimal
vestedQuantity v1alpha1Decimal
exercisedQuantity v1alpha1Decimal
exercisePrice v1alpha1Money
securityLabel string
earlyExercisable boolean
vestingEvents v1alpha1OptionGrantVestingEvent[]
exercises v1alpha1Exercise[]
terminationDate v1alpha1Iso8601CompleteCalendarDate
vestingSchedule issuerssecuritiesv1alpha1VestingSchedule
canceledQuantity v1alpha1Decimal
forfeitedQuantity v1alpha1Decimal
expiredQuantity v1alpha1Decimal
returnedToPoolQuantity v1alpha1Decimal
returnedToTreasuryQuantity v1alpha1Decimal
lastModifiedDatetime v1alpha1Iso8601CompleteCalendarDateTime
exercisePeriods issuerssecuritiesv1alpha1ExercisePeriods

OCF — EquityCompensationIssuance

Object describing securities issuance transaction by the issuer and held by a stakeholder as a form of compensation (as noted elsewhere, RSAs are not included here intentionally and should be modelled using Stock Issuances).

Property Type Required
id STRING REQUIRED
comments [STRING] -
object_type Constants (Backwards Compatibility): TX_PLAN_SECURITY_ISSUANCE, TX_EQUITY_COMPENSATION_ISSUANCE
Defined in schema/enums/ObjectType		 REQUIRED
date schema/types/Date REQUIRED
security_id STRING REQUIRED
custom_id STRING REQUIRED
stakeholder_id STRING REQUIRED
board_approval_date schema/types/Date -
stockholder_approval_date schema/types/Date -
consideration_text STRING -
security_law_exemptions [ schema/types/SecurityExemption ] REQUIRED
stock_plan_id STRING -
stock_class_id STRING -
compensation_type Enum - Compensation Type

Description: Enumeration of equity compensation types (there are some things around the margins like RSAs that don't currently fit under the EquityCompensation umbrella but might arguably fall under this. If you want to create an RSA, create a stock issuance with vesting - you can link it to a plan as well, if you want).

The enums stand for:
1. OPTION_ISO (qualified)
2. OPTION_NSO (non-qualified)
3. OPTION (not NSO or ISO)
4. RSU (restricted share units)
5. CSAR(cash-settled stock appreciation rights)
6. SSAR(stock-settled stock appreciation rights)

ONE OF:
• OPTION_NSO
• OPTION_ISO
• OPTION
• RSU
• CSAR
• SSAR		 REQUIRED
option_grant_type Enum - Option Type

Description: Enumeration of option types

ONE OF:
• NSO
• ISO
• INTL		 -
quantity schema/types/Numeric REQUIRED
exercise_price schema/types/Monetary -
base_price schema/types/Monetary -
early_exercisable BOOLEAN -
vesting_terms_id STRING -
vestings [ schema/types/Vesting ] -
expiration_date ONE OF the Following Types/Objs:
• NULL ()
• schema/types/Date		 REQUIRED
termination_exercise_windows [ schema/types/TerminationWindow ] REQUIRED

Properties

Property Type Required Description
id string The identifier of the option grant.
issuerId string The identifier of the issuer that issued the option grant.
stakeholderId string The identifier of the stakeholder that holds the option grant.
equityIncentivePlanName string The name of the equity incentive plan (i.e., option plan) associated with this option grant.
issueDate v1alpha1Iso8601CompleteCalendarDate The date the option grant was issued.
vestingStartDate v1alpha1Iso8601CompleteCalendarDate The date the option grant began vesting.
boardApprovalDate v1alpha1Iso8601CompleteCalendarDate The date the option grant received board approval.
stakeholderAcceptanceDate v1alpha1Iso8601CompleteCalendarDate The date the option grant was accepted by the stakeholder.
canceledDate v1alpha1Iso8601CompleteCalendarDate The date when this option grant was canceled.
grantExpirationDate v1alpha1Iso8601CompleteCalendarDate The expiration date of the option grant (commonly 10 years from the grant issuance date).
lastExercisableDate v1alpha1Iso8601CompleteCalendarDate The last date the stakeholder can exercise the option grant.
disqualificationDate v1alpha1Iso8601CompleteCalendarDate The date this option grant became disqualified.
isoNsoSplit boolean True if the grant has ISO/NSO split. False otherwise. Learn more about the ISO $100K limit and ISO/NSO splits.
stockOptionType issuerssecuritiesv1alpha1StockOptionType The stock option type at time of issuance. For grants issued as ISO that subsequently failed to meet ISO qualifications, the type will remain ISO. Refer to the disqualification date for information regarding the disqualification of the grant's ISO shares.
quantity v1alpha1Decimal The total number of options in the grant.
outstandingQuantity v1alpha1Decimal The total quantity of stock options from this grant that have not been exercised, expired, forfeited, or canceled
vestedQuantity v1alpha1Decimal The total quantity of stock options from this grant that have vested.
exercisedQuantity v1alpha1Decimal The total quantity of stock options from this grant that have been exercised into shares.
exercisePrice v1alpha1Money The exercise price of the options in the grant.
securityLabel string The label representing this security (option grant).
earlyExercisable boolean True if the option grant is eligible for early exercising; false if the option grant is not eligible for early exercising.
vestingEvents v1alpha1OptionGrantVestingEvent[] The list of all vesting events associated with this grant. For time based vesting events, both past and future vesting details will be available. For performance and milestone based vesting, only achieved vesting events will be available.
exercises v1alpha1Exercise[] The list of all exercises associated with this grant.
terminationDate v1alpha1Iso8601CompleteCalendarDate The date that the option grant was terminated. This commonly matches the date the company's relationship with the stakeholder was terminated.
vestingSchedule issuerssecuritiesv1alpha1VestingSchedule The vesting schedule information associated with the restricted stock award.
canceledQuantity v1alpha1Decimal The number of options in the grant that were canceled.
forfeitedQuantity v1alpha1Decimal The number of options in the grant that were forfeited.
expiredQuantity v1alpha1Decimal The number of options in the grant that expired.
returnedToPoolQuantity v1alpha1Decimal The number of options in the grant that were returned to the pool.
returnedToTreasuryQuantity v1alpha1Decimal The number of options in the grant that were annulled, but not returned to the pool.
lastModifiedDatetime v1alpha1Iso8601CompleteCalendarDateTime The date and time when the option grant was last modified.
exercisePeriods issuerssecuritiesv1alpha1ExercisePeriods The exercise periods for the option grant. Unset values within this field will be inherited from the equity plan from with the option was granted.

Referenced by

(not embedded in other domain objects)

Underlying schema: v1alpha1OptionGrant

← Back to Domain Index