| 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

https://mock-api.carta.com/v1alpha1/issuers/{issuerId}/draftOptionGrantSets/{draftOptionGrantSetId}/draftOptionGrants

```

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

}

}

}

```
