List Option Exercises

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 exercises to retrieve.

pageSize

int32

The maximum number of option exercises to return. The service may return fewer than this value. If unspecified, at most 25 option exercises will be returned. The maximum value is 100; values above 100 will be coerced to 100.

pageToken

string

A page token received as nextPageToken in a previous List Option Exercises 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.

``200 A successful response.

object

The response for the ListOptionExercises endpoint.

optionExercises

array of objects

The option exercises from the specified issuer.

optionExercises

object

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.

id

string

length ≤ 50

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"

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 being exercised.

optionGrantId

string

length ≤ 50

The identifier of the option grant being exercised.

certificateId

string

length ≤ 50

The identifier of the certificate issued as a result of the option exercise event completing.

quantity

object

The number of shares being exercised from the related option grant.

quantity object

exerciseTime

object

The date and time in which the option exercise request was initiated.

exerciseTime object

state

string

enum

The current state of the exercise request.

exerciseType

string

enum

The type of option exercise being requested.

recordType

string

enum

The type of the record associated with the option exercise.

taxWithholding

array of objects

The tax withholding information associated with the option exercise.

taxWithholding

object

Tax withholding information for an option exercise, calculated for a specific jurisdiction for a given stakeholder.

name

string

length ≤ 100

The name of the tax withholding line item.

rate

object

The tax witholding percentage rate for the specified jurisdiction.

rate object taxes

object

The tax to withhold for the specified jurisdiction.

taxes object

jurisdiction

object

The jurisdiction for which the tax withholding is calculated.

jurisdiction object

moneyMovement

object

The money movement information associated with the option exercise.

moneyMovement object

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.

Updatedabout 2 months ago

{
  "optionExercises": [
    {
      "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"
        }
      }
    }
  ],
  "nextPageToken": "Nzg2Mg=="
}

Updatedabout 2 months ago