Create a Draft Option Grant
| Time | Status | User Agent | |
|---|---|---|---|
| Make a request to see history. |
URL Expired
The URL for this request expired after 30 days.
issuerId
string
required
The identifier of the issuer of the grant.
draftOptionGrantSetId
string
required
The identifier of the draft option grant set will contain the draft option grant.
The “LATEST” string can be used as an draft_option_grant_set_id in case you don’t want to pin a specific draft option grant set.
By using LATEST, it will look for the most recently created draft option grant set for the issuer, and create the draft option grant in that set.
If no draft option grant set exists, it will create a new draft option grant set and use it.
The request for the CreateDraftOptionGrant endpoint.
draftOptionGrant
object
required
The draft option grant to be created
draftOptionGrant object
`` 200 A successful response.
object
The response for the CreateDraftOptionGrant endpoint.
draftOptionGrant
object
The created draft option grant
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
string
enum
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
string
enum
The type of the option grant. grantReason
string
enum
The reason for granting the option.
quantity
object
The quantity of shares awarded in the option grant.
quantity object
earlyExercise
boolean
Whether the option grant allows for early exercise.
exercisePrice
object
The exercise price of the option grant.
exercisePrice object
stakeholder
object
The stakeholder to whom this security will be issued.
Details of a stakeholder object
compliance
object
The compliance details of the stakeholder.
Compliance details of a stakeholder object
vesting
object
The vesting details of the option grant.
The vesting details of the option grant object
notes
string
length ≤ 1000
Additional notes about the option grant.
createTime
object
Output only. The timestamp when the option grant was created.
createTime object
updateTime
object
Output only. The timestamp when the option grant was last updated.
updateTime object
customLabel
string
length ≤ 32
A custom identifier for the draft option grant.
boardApproval
string
enum
The board approval status for the draft option grant.
boardApprovalDate
object
The board approval date for the draft option grant. Only provide if the board_approval status is approved.
Represents a whole or partial calendar date, e.g. a birthday. The time of day and time zone are either specified elsewhere or are not significant. The date is relative to the Proleptic Gregorian Calendar. This can represent: object
grantDate
object
The grant date for the draft option grant.
expirationDate
object
The expiration date for the draft option grant.
exercisePeriods
object
The exercise periods for the draft option grant.
exercisePeriods object documents
object
Optional documents that are relevant to a draft option grant.
documents object
`` 400 Returned if required fields are omitted or if provided fields fail validation.
`` 401 Returned if a valid Authorization header has not been included with the request.
`` 403 Returned when the user does not have permission to access the resource.
`` 500 Returned if an unexpected internal server error is encountered.
`` default An unexpected error response.
Updated about 2 months ago
ShellNodeRubyPHPPython
Bearer
Base URL
xxxxxxxxxx
curl --request POST \
--url https://mock-api.carta.com/v1alpha1/issuers/issuerId/draftOptionGrantSets/draftOptionGrantSetId/draftOptionGrants \
--header 'accept: application/json' \
--header 'content-type: application/json'
xxxxxxxxxx
{
"draftOptionGrant": {
"id": "6eeb0b6f-84c4-4071-8d94-9f0cefd59230",
"draftOptionGrantSetId": "6431d9c0-cba4-4134-8f1a-647d3d14e241",
"issuerId": "0791d98d-8d65-43ac-9571-749070054821",
"state": "DRAFT_SECURITY_STATE_DRAFTING",
"stockOptionType": "STOCK_OPTION_TYPE_ISO",
"grantReason": "GRANT_REASON_NEW_HIRE",
"quantity": {
"value": "1000.0"
},
"earlyExercise": false,
"exercisePrice": {
"currency_code": "USD",
"amount": {
"value": "100.0"
}
},
"stakeholder": {
"name": "Jane Doe",
"email": "jane.doe@example.com",
"employeeId": "ASDF-123",
"type": "STAKEHOLDER_TYPE_INDIVIDUAL",
"relationship": "STAKEHOLDER_RELATIONSHIP_EMPLOYEE"
},
"compliance": {
"countryOfResidency": {
"value": "USA"
},
"stateOfResidency": {
"value": "US-CA"
},
"federalExemption": "RULE_701"
},
"notes": "Additional note about drafting",
"createTime": {
"value": "2024-02-29T18:18:00Z"
},
"updateTime": {
"value": "2024-02-29T18:18:00Z"
},
"vesting": {
"templateId": "6eeb0b6f-84c4-4071-8d94-9f0cefd59230",
"startDate": {
"year": 2024,
"month": 2,
"day": 29
},
"acceleration": {
"name": "Acceleration name",
"terms": "Accel Terms"
}
},
"customLabel": "ABC-123",
"grantDate": {
"year": 2024,
"month": 2,
"day": 29
},
"boardApprovalDate": {
"year": 2024,
"month": 2,
"day": 29
},
"boardApproval": "BOARD_APPROVAL_APPROVED",
"expirationDate": {
"year": 2034,
"month": 2,
"day": 29
}
}
}