| Time | Status | User Agent | | | :-- | :-- | :-- | :-- | | Make a request to see history. | #### 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](https://en.wikipedia.org/wiki/ISO_8601), 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](https://en.wikipedia.org/wiki/ISO_8601), 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. ```bash 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=" }