Get Restricted Stock Award

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 owning the restricted stock award to retrieve.

string

required

The identifier of the restricted stock award to retrieve.

``200 A successful response.

object

The response from the Get Restricted Stock Award endpoint.

restrictedStockAward

object

The requested restricted stock award from the specified issuer.

string

length ≤ 50

The identifier of the restricted stock award.

securityId

string

length ≤ 50

The UUID of the restricted stock award. Use this to cross-reference with the List Transactions API.

shareClassId

string

length ≤ 50

The UUID of the share class for this restricted stock award. May be absent if there is no associated share class.

vestingScheduleTemplateId

string

length ≤ 50

The UUID of the vesting schedule template used by this restricted stock award. May be absent if the award has no vesting schedule.

issuerId

string

length between 1 and 50

The identifier of the issuer owning the restricted stock award.

stakeholderId

string

length ≤ 50

The identifier of the stakeholder that holds the restricted stock award.

equityIncentivePlanName

string

length ≤ 100

The name of the equity incentive plan (i.e., option plan) associated with this restricted stock award.

shareClassName

string

length ≤ 50

The name of the share class that this restricted stock award belongs to.

issueDate

object

The date the restricted stock award was issued.

issueDate object

vestingStartDate

object

The start date of the vesting period for the restricted stock award.

vestingStartDate object

boardApprovalDate

object

The date the restricted stock award received board approval.

boardApprovalDate object

stakeholderAcceptanceDate

object

The date the restricted stock award was accepted by the stakeholder.

stakeholderAcceptanceDate object

canceledDate

object

The date the restricted stock award was canceled.

canceledDate object

terminationDate

object

The date the restricted stock award was terminated. This commonly matches the date the company's relationship with the stakeholder was terminated.

terminationDate object

quantity

object

The number of restricted stock units in the award.

quantity object

vestedQuantity

object

The number of vested shares in the stock award.

vestedQuantity object

securityLabel

string

length ≤ 50

The label representing this security (restricted stock award).

pricePerShare

object

The cost of each share in the restricted stock award.

pricePerShare object

vestingEvents

array of objects

The list of all vesting events associated with the restricted stock award.

vestingEvents

object

Restricted stock award vesting event information.

string

length ≤ 50

The identifier of the restricted stock award vesting event.

vestDate

object

The date of the vesting event. For milestone-based vesting events, vestDate will be omitted until the security has vested.

vestDate object

quantity

object

The number of shares being vested in this vesting event by this event’s date.

Deprecated: use maxQuantity, targetQuantity, vestedQuantity fields instead.

For vesting events from strictly time-based vesting schedules, this field will be the amount of shares vesting in the tranche represented by this vesting event, regardless of whether the tranche has actually vested.

For vesting events with performance conditions, this field will be set to either:

if the performance condition has not been achieved, the maximum quantity of shares that could be vested
if the performance condition has been achieved, the target quantity of shares that are vested based on the payout details of the performance condition

The number of shares being vested in this vesting event by this event’s date. Deprecated. object

performanceCondition

boolean

Indicates that this vesting event has associated performance or milestone vesting conditions.

performanceCondition will be true for milestone- and performance-based vesting events.

For performance-based vesting events, performanceCondition indicates that a performance condition exists, not that it has been met.

vested

boolean

Indicates that this vesting event has vested.

maxQuantity

object

The maximum number of shares vested in this vesting event.

For vesting events with performance conditions, this value will be based on the maximum payout defined within the performance condition.

For regular time-based vesting events, this value will be equivalent to the target_payout field.

The maximum number of shares vested in this vesting event. object

targetQuantity

object

The target number of shares vested in this vesting event.

The target number of shares reflects the number of shares that have vested or should vest within the vesting event independent of any performance condition payout details.

If this vesting event has no performance condition, then this value will reflect the value that is or will be in the vestedQuantity field.

The target number of shares vested in this vesting event. object

vestedQuantity

object

The actual number of shares vested in this vesting event.

This value will only be set if the vesting event is actually vested (i.e., the vested field is true). Otherwise, if the vesting event is unvested, then this value will be unset.

The actual number of shares vested in this vesting event. object

vestingSchedule

object

The vesting schedule information associated with the restricted stock award.

vestingSchedule object

canceledQuantity

object

The number of shares in the restricted stock award that were canceled.

canceledQuantity object

returnedToPoolQuantity

object

The number of shares in the restricted stock award that were returned to the pool.

returnedToPoolQuantity object

returnedToTreasuryQuantity

object

The number of shares in the restricted stock award that were annulled, but not returned to the pool.

returnedToTreasuryQuantity object

lastModifiedDatetime

object

The date and time when the restricted stock award was last modified.

lastModifiedDatetime object

precededBy

object

The origin/history of the restricted stock award, describing which prior security (if any) it was issued from and why. Needed to distinguish primary vs secondary issuances for cap table summaries.

precededBy object

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


xxxxxxxxxx

curl --request GET \

--url https://mock-api.carta.com/v1alpha1/issuers/issuerId/restrictedStockAwards/id \

--header 'accept: application/json'


xxxxxxxxxx

{
  "restrictedStockAward": {
    "id": "1191",
    "securityId": "a7b8c9d0-e1f2-3456-abcd-567890123456",
    "shareClassId": "f2a3b4c5-d6e7-8901-fabc-012345678901",
    "vestingScheduleTemplateId": "a3b4c5d6-e7f8-9012-abcd-123456789abc",
    "issuerId": "7",
    "stakeholderId": "6113",
    "equityIncentivePlanName": "2016 Equity Incentive Plan",
    "shareClassName": "Common",
    "issueDate": {
      "value": "2016-08-25"
    },
    "vestingStartDate": {
      "value": "2016-08-25"
    },
    "boardApprovalDate": {
      "value": "2016-12-01"
    },
    "stakeholderAcceptanceDate": {
      "value": "2017-02-27"
    },
    "canceledDate": {
      "value": "2022-05-02"
    },
    "quantity": {
      "value": "200000"
    },
    "vestedQuantity": {
      "value": "200000"
    },
    "securityLabel": "RSA-3",
    "pricePerShare": {
      "currencyCode": {
        "value": "USD"
      },
      "amount": {
        "value": "0.01"
      }
    },
    "vestingEvents": [\
      {\
        "id": "1988",\
        "vestDate": {\
          "value": "2018-02-27"\
        },\
        "quantity": {\
          "value": "200000"\
        },\
        "performanceCondition": false,\
        "vested": true,\
        "maxQuantity": {\
          "value": "200000"\
        },\
        "targetQuantity": {\
          "value": "200000"\
        },\
        "vestedQuantity": {\
          "value": "200000"\
        }\
      }\
    ],
    "vestingSchedule": {
      "name": "1/24 Cliff",
      "lastModifiedDate": {
        "value": "2022-01-31"
      },
      "startDate": {
        "value": "2022-01-31"
      },
      "endDate": {
        "value": "2024-01-31"
      }
    },
    "lastModifiedDatetime": {
      "value": "2024-07-30T09:31:57.000000Z"
    }
  }
}

URL Expired

``200 A successful response.

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

``401 Returned if a valid `Authorization` header has not been included with the request.