List Option Grants
| 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 that issued the option grants to retrieve.
pageSize
int32
The maximum number of option grants to return. The service may return fewer than this value.
If unspecified, at most 25 funds will be returned.
The maximum value is 50; values above 50 will be coerced to 50.
pageToken
string
A page token received as nextPageToken in a previous List Option Grants response. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to optionGrants must match the call that provided the page token.
lastModifiedDatetimeAfter
string
Return option grants that were last modified on or after this date and time. Uses UTC and is specified in ISO 8601 format, i.e. 'YYYY-MM-DDThh:mm:ssZ'.
lastModifiedDatetimeBefore
string
Return option grants that were last modified on or before this date and time. Uses UTC and is specified in ISO 8601 format, i.e. 'YYYY-MM-DDThh:mm:ssZ'.
```200 A successful response.
object
The response for the ListOptionGrants endpoint.
optionGrants
array of objects
The vesting schedules from the specified issuer.
optionGrants
object
An option grant is a contract that gives an employee the right to purchase a company's stock at a set price.
- id: string, length ≤ 50 - The identifier of the option grant.
- securityId: string, length ≤ 50 - The UUID of the option grant. Use this to cross-reference with the List Transactions API.
- shareClassId: string, length ≤ 50 - The UUID of the share class for this option grant. May be absent if there is no associated share class.
- vestingScheduleTemplateId: string, length ≤ 50 - The UUID of the vesting schedule template used by this option grant. May be absent if the grant has no vesting schedule.
- issuerId: string, length ≤ 50 - The identifier of the issuer that issued the option grant.
- stakeholderId: string, length ≤ 50 - The identifier of the stakeholder that holds the option grant.
- equityIncentivePlanName: string, length ≤ 100 - The name of the equity incentive plan (i.e., option plan) associated with this option grant.
- issueDate: object - The date the option grant was issued.
- vestingStartDate: object - The date the option grant began vesting.
- boardApprovalDate: object - The date the option grant received board approval.
- stakeholderAcceptanceDate: object - The date the option grant was accepted by the stakeholder.
- canceledDate: object - The date when this option grant was canceled.
- grantExpirationDate: object - The expiration date of the option grant (commonly 10 years from the grant issuance date).
- lastExercisableDate: object - The last date the stakeholder can exercise the option grant.
- disqualificationDate: object - The date this option grant became disqualified.
- isoNsoSplit: boolean - True if the grant has ISO/NSO split. False otherwise.
- stockOptionType: string, enum - 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: object - The total number of options in the grant.
- outstandingQuantity: object - The total quantity of stock options from this grant that have not been exercised, expired, forfeited, or canceled
- vestedQuantity: object - The total quantity of stock options from this grant that have vested.
- exercisedQuantity: object - The total quantity of stock options from this grant that have been exercised into shares.
- exercisePrice: object - The exercise price of the options in the grant.
- securityLabel: string, length ≤ 50 - 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: array of objects - 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: array of objects - The list of all exercises associated with this grant.
- vestingSchedule: object - The vesting schedule information associated with the restricted stock award.
- lastModifiedDatetime: object - The date and time when the option grant was last modified.
nextPageToken: string - Submit the nextPageToken string as pageToken in a subsequent request to retrieve the next page.
If the response omits nextPageToken, then there are no subsequent pages.