| 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](https://en.wikipedia.org/wiki/ISO_8601), 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](https://en.wikipedia.org/wiki/ISO_8601), 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.

# ```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.