Skip to content

Draft Option Grant

A draft option grant is an object that is the precursor of an option grant before it is approved, signed, and issued. The "draft" prefix is used to differentiate it from the final option grant object.

OCF Equivalent

OCF has no "draft" state for equity grants — it only models finalized transactions. A Carta draft maps to a pending EquityCompensationIssuance that hasn't been committed.

Endpoints

  • POST /v1alpha1/issuers/{issuerId}/draftOptionGrantSets/{draftOptionGrantSetId}/draftOptionGrants — single (request body)
  • POST /v1alpha1/issuers/{issuerId}/draftOptionGrantSets/{draftOptionGrantSetId}/draftOptionGrants — single
  • GET /v1alpha1/issuers/{issuerId}/draftOptionGrantSets/{draftOptionGrantSetId}/draftOptionGrants/{draftOptionGrantId} — 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 — v1alpha1DraftOptionGrant

A draft option grant is an object that is the precursor of an option grant before it is approved, signed, and issued. The "draft" prefix is used to differentiate it from the final option grant object.

Property Type Req
id string
draftOptionGrantSetId string
issuerId string
optionGrantId string
state v1alpha1DraftSecurityState
stockOptionType issuersdraftsecuritiesv1alpha1StockOptionType
grantReason v1alpha1GrantReason
quantity v1alpha1Decimal
earlyExercise boolean
exercisePrice v1alpha1Money
stakeholder issuersdraftsecuritiesv1alpha1Stakeholder
compliance v1alpha1Compliance
vesting v1alpha1Vesting
notes string
createTime v1alpha1Iso8601CompleteCalendarDateTime
updateTime v1alpha1Iso8601CompleteCalendarDateTime
customLabel string
boardApproval v1alpha1BoardApproval
boardApprovalDate v1alpha1Date
grantDate v1alpha1Date
expirationDate v1alpha1Date
exercisePeriods issuersdraftsecuritiesv1alpha1ExercisePeriods
documents v1alpha1OptionGrantDocuments

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 Output only. The unique identifier of the draft option grant.
draftOptionGrantSetId string Output only. The unique identifier of the draft option grant set.
issuerId string Output only. The unique identifier of the issuer.
optionGrantId string Output only. The unique identifier of the option grant that is originated by this draft once it is issued.
state v1alpha1DraftSecurityState Output only. The state of the draft option grant. Certain states are read-only and the draft option grant cannot be modified in those states.
stockOptionType issuersdraftsecuritiesv1alpha1StockOptionType The type of the option grant.
grantReason v1alpha1GrantReason The reason for granting the option.
quantity v1alpha1Decimal The quantity of shares awarded in the option grant.
earlyExercise boolean Whether the option grant allows for early exercise.
exercisePrice v1alpha1Money The exercise price of the option grant.
stakeholder issuersdraftsecuritiesv1alpha1Stakeholder The stakeholder to whom this security will be issued.
compliance v1alpha1Compliance The compliance details of the stakeholder.
vesting v1alpha1Vesting The vesting details of the option grant.
notes string Additional notes about the option grant.
createTime v1alpha1Iso8601CompleteCalendarDateTime Output only. The timestamp when the option grant was created.
updateTime v1alpha1Iso8601CompleteCalendarDateTime Output only. The timestamp when the option grant was last updated.
customLabel string A custom identifier for the draft option grant.
boardApproval v1alpha1BoardApproval The board approval status for the draft option grant.
boardApprovalDate v1alpha1Date The board approval date for the draft option grant. Only provide if the board_approval status is approved.
grantDate v1alpha1Date The grant date for the draft option grant.
expirationDate v1alpha1Date The expiration date for the draft option grant.
exercisePeriods issuersdraftsecuritiesv1alpha1ExercisePeriods The exercise periods for the draft option grant.
documents v1alpha1OptionGrantDocuments Optional documents that are relevant to a draft option grant.

Referenced by

(not embedded in other domain objects)

Underlying schema: v1alpha1DraftOptionGrant

← Back to Domain Index