URL Expired

The URL for this request expired after 30 days.

portfolioId
string
required
The identifier of the portfolio holding the restricted stock awards to retrieve.

issuerId
string
required
The identifier of the issuer that has issued the restricted stock awards to retrieve.

pageSize
int32
The maximum number of restricted stock awards to return. The service may return fewer than this value.

If unspecified, at most 25 restricted stock awards will be returned.

The maximum value is 50; values above 50 will be coerced to 50.

pageToken
string
A page token received as nextPageToken in a previous List Restricted Stock Awards response. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to restrictedStockAwards must match the call that provided the page token.

lastModifiedDatetimeAfter
string
Return restricted stock awards that were last modified on or after this date and time. Uses UTC and is specified in ISO 8601 format, i.e. 'YYYY-MM-DDThh:mm:ssZ'.

lastModifiedDatetimeBefore
string
Return restricted stock awards that were last modified on or before this date and time. Uses UTC and is specified in ISO 8601 format, i.e. 'YYYY-MM-DDThh:mm:ssZ'.

Response Codes

• 200 A successful response.

object
The response from the List Restricted Stock Awards endpoint.

restrictedStockAwards
array of objects
The restricted stock awards from the specified portfolio.

restrictedStockAwards
object
A restricted stock award is a grant of company shares.

• id
  string
  length ≤ 50 The identifier of the restricted stock award.

• 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. Usually this matches the date the company's relationship with a stakeholder was terminated.

terminationDate object

• quantity
  object
  The number of restricted stock units in the award.

quantity object

• vestedQuantity
  object
  The number of shares that have been vested for this 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 this restricted stock award.

vestingEvents object

• id
  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, and vestedQuantity fields instead.

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

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

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

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

vestingSchedule object

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

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

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

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

lastModifiedDatetime object

nextPageToken
string
Submit the nextPageToken string as pageToken in a subsequent request to retrieve the next page.

If the List Restricted Stock Awards response omits nextPageToken, then there are no subsequent pages.

Response Codes

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

curl --request GET \
     --url https://mock-api.carta.com/v1alpha1/portfolios/portfolioId/issuers/issuerId/restrictedStockAwards \
     --header 'accept: application/json'

{ "restrictedStockAwards": [ { "id": "29", "issuerId": "7", "stakeholderId": "4902", "equityIncentivePlanName": "2013 Equity Incentive Plan", "shareClassName": "Common", "issueDate": { "value": "2021-01-01" }, "vestingStartDate": { "value": "2013-01-31" }, "boardApprovalDate": { "value": "2013-01-31" }, "stakeholderAcceptanceDate": { "value": "2014-02-12" }, "canceledDate": { "value": "2017-10-26" }, "quantity": { "value": "2500000" }, "vestedQuantity": { "value": "2500000" }, "securityLabel": "CS-1", "pricePerShare": { "currencyCode": { "value": "USD" }, "amount": { "value": "0.10" } }, "vestingEvents": [ { "id": "1988", "vestDate": { "value": "2013-02-28" }, "quantity": { "value": "52083" }, "performanceCondition": false, "vested": true } ], "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" } } ], "nextPageToken": "NDY=" }