---
title: StockGrant
slug: stockgrant
docTags: 
createdAt: 2021-09-14T20:22:06.000Z
---

A *Carrot* datatype used by fields that store equity grant values. 

:::hint{type="info"}
The `StockGrant` datatype is not supported by Custom Fields. Supported uses for the `StockGrants` datatype are currently limited to the default fields `grants`, `grantShares`, and `grantType`.
:::

### Properties

The `StockGrant` datatype supports the following properties:

| **Property**                   | **Definition**                                          |
| ------------------------------ | ------------------------------------------------------- |
| *StockGrant*.**id**            | Returns the grant ID.                                   |
| *StockGrant*.**stock**         | Returns the ticker symbol of this stock.                |
| *StockGrant*.**date**          | Returns the date of the grant.                          |
| *StockGrant*.**vestDate**      | Returns the vesting start date of the grant.            |
| *StockGrant*.**expireDate**    | Returns the expiration date of the grant.               |
| *StockGrant*.**shares**        | Returns the number of shares granted.                   |
| *StockGrant*.**price**         | Returns the per-share strike price.                     |
| *StockGrant*.**type**          | Returns the type of grant.                              |
| *StockGrant*.**vest**          | Returns the vesting schedule.                           |
| *StockGrant*.**originalPrice** | Returns the per share grant price at the time of issue. |
| *StockGrant*.**currentPrice**  | Returns the current per share grant price.              |
| *StockGrant*.**vestedShares**  | Returns the current number of shares vested.            |
| *StockGrant*.**vestEndDate**   | Returns the vesting end date.                           |
| *StockGrant*.**cancelDate**    | Returns the cancellation date.                          |
| *StockGrant*.**originalValue** | Returns the original value of the grants.               |
| *StockGrant*.**currentValue**  | Returns the current value of the grants.                |