| Time |
Status |
User Agent |
|
| Make a request to see history. |
|
|
|
URL Expired
The URL for this request expired after 30 days.
Request Parameters
issuerId
- Type: string
- Required: Yes
- Description: The identifier of the issuer whose fair market values are being retrieved.
pageSize
- Type: int32
- Description: The maximum number of fair market values to return. The service may return fewer than this value.
- If unspecified, at most 25 fair market values will be returned.
- The maximum value is 50; values above 50 will be coerced to 50.
pageToken
- Type: string
- Description: A page token received as
nextPageToken in a previous List Fair Market Values response. Provide this to retrieve the subsequent page.
- When paginating, all other parameters must be kept consistent with those used in the request where the page token was obtained.
Response Structure
200 - A successful response.
- Type: object
- Description: The response from the List Fair Market Values endpoint.
fairMarketValues
- Type: array of objects
- Description: The fair market values from the specified issuer.
fairMarketValues object
- Description: The fair market value contains the accepted values of an issuer's stock, specified on a per-share class basis. These values come from the 409A reports that Carta has for the issuer.
| Field |
Type |
Description |
| id |
string |
An identifier for the 409A fair market values. |
| effectiveDate |
object |
The date that this fair market valuation takes effect. |
| expirationDate |
object |
The date that this fair market valuation will expire. |
| staleDate |
object |
The date that this fair market valuation becomes stale. |
| shareClassValuations |
array of objects |
A list of fair market values for each share class. |
shareClassValuations object
- Description: The fair market valuation price for a share class.
| Field |
Type |
Description |
| shareClassId |
string |
The identifier of the share class. |
| shareClassName |
string |
The name of the share class. |
| common |
boolean |
True if this is a common share class; otherwise, false if this is a preferred share class. |
| price |
object |
The fair market value for the share class. |
Next Page Token
- Submit the
nextPageToken string as pageToken in a subsequent request to retrieve the next page.
- If the List Fair Market Values response omits
nextPageToken, then there are no subsequent pages.
Error Responses
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.
Example Request
curl --request GET \
--url https://mock-api.carta.com/v1alpha1/issuers/issuerId/fairMarketValues \
--header 'accept: application/json'
Example Response
{
"fairMarketValues": [
{
"id": "string",
"effectiveDate": { "value": "2014-03-17" },
"expirationDate": { "value": "2015-03-16" },
"staleDate": { "value": "2015-03-16" },
"shareClassValuations": [
{
"shareClassId": "9",
"shareClassName": "Common",
"common": true,
"price": {
"currencyCode": { "value": "USD" },
"amount": { "value": "0.20" }
}
}
]
}
],
"nextPageToken": "NDY="
}