Shareworks · Schema

Grant Body

Equity CompensationStock OptionsRSUESPPEmployee EquityFinancial ServicesMorgan StanleyEquity AdministrationPrivate CompaniesPublic Companies

Properties

Name	Type	Description
planId	integer	Identifier for the company plan
grantName	string	Name for the grant, typically generated
awardTypeId	integer	Identifier for the company award type
grantDate	string	Date on which the shares are granted
expiryDate	string	Expiry date for the grant
grantPrice	number	Price at which the shares are granted
grantCurrency	string	Currency for the grant price / market price at time of grant
grantedShares	number	Quantity of shares for the grant
vestingScheduleId	integer	Identifier for the vesting schedule
vestingStartDate	string	Vesting base or commencement date for the vesting schedule
marketPriceAtTimeOfGrant	number	The fair market value (or latest 409A valuation for private companies) at the time of grant (this is typically auto-populated from the most recent quote, but can also be specified if desired)
allowEarlyExercise	boolean	Whether early exercises are allowed for the grant
underRule701	boolean	Whether rule 701 applies to the grant
manualVestingRows	array	List of all manual vesting rows for the grant, specified when using a manual vesting schedule
vestingAcceleration	array	(Optional) List of the vesting acceleration stipulations of the grant. May be empty. Include one stipulation per trigger that is applicable.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/shareworks/main/json-schema/StakeholderGrantCrudRequest.json",
  "title": "Grant Body",
  "required": [
    "allowEarlyExercise",
    "awardTypeId",
    "expiryDate",
    "grantCurrency",
    "grantDate",
    "grantPrice",
    "grantedShares",
    "planId",
    "underRule701",
    "vestingScheduleId"
  ],
  "type": "object",
  "properties": {
    "planId": {
      "type": "integer",
      "description": "Identifier for the company plan",
      "format": "int32"
    },
    "grantName": {
      "type": "string",
      "description": "Name for the grant, typically generated"
    },
    "awardTypeId": {
      "type": "integer",
      "description": "Identifier for the company award type",
      "format": "int32"
    },
    "grantDate": {
      "type": "string",
      "description": "Date on which the shares are granted",
      "format": "date"
    },
    "expiryDate": {
      "type": "string",
      "description": "Expiry date for the grant",
      "format": "date"
    },
    "grantPrice": {
      "type": "number",
      "description": "Price at which the shares are granted",
      "format": "double"
    },
    "grantCurrency": {
      "type": "string",
      "description": "Currency for the grant price / market price at time of grant",
      "enum": [
        "USD",
        "CAD",
        "GBP",
        "EUR",
        "JPY",
        "AUD",
        "KRW",
        "DZD",
        "AOA",
        "ARS",
        "AMD",
        "AWG",
        "BSD",
        "BHD",
        "BDT",
        "BBD",
        "BOB",
        "BWP",
        "BRL",
        "BND",
        "BGN",
        "BZD",
        "KYD",
        "CLP",
        "CNY",
        "COP",
        "CRC",
        "HRK",
        "CZK",
        "DKK",
        "DOP",
        "XCD",
        "EGP",
        "ETB",
        "FJD",
        "XAF",
        "GMD",
        "GHS",
        "GIP",
        "GTQ",
        "HNL",
        "HKD",
        "HUF",
        "ISK",
        "INR",
        "IDR",
        "IQD",
        "ILS",
        "JMD",
        "JOD",
        "KZT",
        "KES",
        "KWD",
        "LSL",
        "MOP",
        "MWK",
        "MYR",
        "MUR",
        "MXN",
        "MAD",
        "MZN",
        "MMK",
        "NAD",
        "ANG",
        "NZD",
        "NGN",
        "NOK",
        "OMR",
        "PKR",
        "PAB",
        "PGK",
        "PYG",
        "PEN",
        "PHP",
        "PLN",
        "QAR",
        "RON",
        "RUB",
        "SAR",
        "RSD",
        "SCR",
        "SGD",
        "ZAR",
        "SDG",
        "LKR",
        "SZL",
        "SEK",
        "CHF",
        "TWD",
        "TZS",
        "THB",
        "TTD",
        "TND",
        "TRY",
        "UGX",
        "UAH",
        "AED",
        "UYU",
        "UZS",
        "VEF",
        "VES",
        "VND",
        "XOF",
        "ZWL",
        "ZMW"
      ]
    },
    "grantedShares": {
      "type": "number",
      "description": "Quantity of shares for the grant",
      "format": "double"
    },
    "vestingScheduleId": {
      "type": "integer",
      "description": "Identifier for the vesting schedule",
      "format": "int32"
    },
    "vestingStartDate": {
      "type": "string",
      "description": "Vesting base or commencement date for the vesting schedule",
      "format": "date"
    },
    "marketPriceAtTimeOfGrant": {
      "type": "number",
      "description": "The fair market value (or latest 409A valuation for private companies) at the time of grant (this is typically auto-populated from the most recent quote, but can also be specified if desired)",
      "format": "double"
    },
    "allowEarlyExercise": {
      "type": "boolean",
      "description": "Whether early exercises are allowed for the grant"
    },
    "underRule701": {
      "type": "boolean",
      "description": "Whether rule 701 applies to the grant"
    },
    "manualVestingRows": {
      "type": "array",
      "description": "List of all manual vesting rows for the grant, specified when using a manual vesting schedule",
      "items": {
        "$ref": "#/components/schemas/ManualVestingRowCrudRequest"
      }
    },
    "vestingAcceleration": {
      "type": "array",
      "description": "(Optional) List of the vesting acceleration stipulations of the grant. May be empty. Include one stipulation per trigger that is applicable.",
      "items": {
        "$ref": "#/components/schemas/StakeholderGrantAcceleratedVestingCrudRequest"
      }
    }
  }
}