Skip to content

Option exercise

Option Exercise

Endpoints: GET /v1alpha1/issuers/{issuerId}/optionExercises

Description: An option exercise is an event representing a stakeholder exercising their right to purchase shares of an issuer at a set price, the strike price, defined in the option grant being exercised. The result of a successfully completed exercise is the issuance of a certificate.

Referenced By (1): - List Option Exercises Response

References (7): - Securitiesoptionexercises Stock Option Type - Decimal - Iso8601 Complete Calendar Date Time - Option Exercise Money Movement - Option Exercise State - Option Exercise Tax Withholding Line Item - Option Exercise Type

Example: 

{
  "id": "JZgiQfmZpvuiLbhXXQXfZi",
  "issuerId": "7",
  "stakeholderId": "6113",
  "optionGrantId": "9387",
  "certificateId": "4732",
  "quantity": {
    "value": "100"
  },
  "exerciseTime": {
    "value": "2024-01-01T09:00:00.000000Z"
  },
  "state": "COMPLETE",
  "exerciseType": "CASH_EXERCISE",
  "recordType": "ISO",
  "taxWithholding": [
    {
      "name": "Federal",
      "rate": {
        "value": "20"
      },
      "taxes": {
        "currencyCode": "USD",
        "amount": {
          "value": "200"
        }
      },
      "jurisdiction": {
        "city": "NewYork",
        "countrySubdivision": "US-NY",
        "country": "USA"
      }
    }
  ],
  "moneyMovement": {
    "completionDate": {
      "value": "2024-02-10T09:00:00.000000Z"
    }
  }
}

Properties:

Property Type Description Required
certificateId STRING The identifier of the certificate issued as a result of the option exercise event completing.
Constraints: Max length: 50		 -
exerciseTime Iso8601 Complete Calendar Date Time The date and time in which the option exercise request was initiated. -
exerciseType Option Exercise Type The type of option exercise being requested. -
id STRING The identifier of the option exercise. Note: It is possible for this ID to not exist for legacy reasons, in which case the value of this field will be "NO_ID"
Constraints: Max length: 50		 -
issuerId STRING The identifier of the issuer that issued the option grant.
Constraints: Max length: 50		 -
moneyMovement Option Exercise Money Movement The money movement information associated with the option exercise. -
optionGrantId STRING The identifier of the option grant being exercised.
Constraints: Max length: 50		 -
quantity Decimal The number of shares being exercised from the related option grant. -
recordType Securitiesoptionexercises Stock Option Type The type of the record associated with the option exercise. -
stakeholderId STRING The identifier of the stakeholder that holds the option grant being exercised.
Constraints: Max length: 50		 -
state Option Exercise State The current state of the exercise request. -
taxWithholding [Array of Option Exercise Tax Withholding Line Item] The tax withholding information associated with the option exercise. -