| Time | Status | User Agent | | | :-- | :-- | :-- | :-- | | Make a request to see history. | #### URL Expired The URL for this request expired after 30 days. ## API Reference ### Parameters - **firmId** `string` required The identifier of the firm. - **fundId** `string` required The identifier of the fund or `-` to list convertible notes across all funds under the firm specified by `firm_id`. - **investmentId** `string` required The identifier of the investment or `-` to list convertible notes across all company investments under the fund specified by `firmId` and `fundId`. - **asOfDate** `string` _Deprecated_ Return convertible notes with issue dates on or after this date, specified as an [ISO 8601 extended format calendar date](https://en.wikipedia.org/wiki/ISO_8601#Calendar_dates), i.e. 'YYYY-MM-DD'. - **pageSize** `int32` The maximum number of convertible notes to return. The service may return fewer than this value. If unspecified, at most 25 convertible notes 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 `ListConvertibleNotes` response. Provide this to retrieve the subsequent page. ### Response - **200** A successful response. - **object** The response from the `ListConvertibleNotes` endpoint. - **convertibleNotes** `array of objects` The convertible notes returned in the `ListConvertibleNotes` response. - **convertibleNotes** `object` A convertible note. - **firmId** `string` length between 1 and 50 The identifier of the investment firm that holds the convertible note. - **firmName** `string` length between 1 and 1000 The name of the investment firm that holds the convertible note. - **fundId** `string` length between 1 and 50 The identifier of the investment fund that manages the convertible note. - **fundName** `string` length between 1 and 1000 The name of the investment fund that manages the convertible note. - **companyId** `string` length between 1 and 50 The identifier of the company that issued the convertible note. - **companyName** `string` length between 1 and 1000 The name of the company that issued the convertible note. - **currentStakeholderId** `string` length between 1 and 50 The identifier of the stakeholder currently holding the convertible note. - **id** `string` length between 1 and 50 The identifier of the convertible note. - **securityLabel** `string` length between 1 and 50 The label representing the convertible note. - **issueDate** `object` The date the convertible note was issued. - **conversionDate** `object` The date the convertible note was converted to a certificate. - **canceledDate** `object` The date the convertible note was canceled. - **cashPaid** `object` required The amount of cash that the stakeholder paid for the convertible note. - **maturityDate** `object` The date on which the convertible note matures. - **interest** `object` required The accrued interest for the convertible note. - **noteBlock** `object` required The note block associated with the convertible note. - **interestAccrualPeriod** `string` enum The length of time over which the interest due to the lender is calculated. - **interestRate** `object` The annual interest rate that the note accrues. - **interestCompoundingPeriod** `string` enum required The interest compounding period of the convertible note. - **dayCountBasis** `string` enum required The standardized way of counting the number of days between two dates. - **priceCap** `object` The valuation cap sets a maximum value at which a convertible security will convert into equity in the financing round. - **discountPercentage** `object` The discount applied to the price per share when the note holder will purchase shares in the next fundraising round. 1 represents 1%. - **changeInControlPercent** `object` Denotes any premium or multiplier applied to the `cash_paid` in the event of a change in control prior to the maturity date. 1 represents 1%. - **conversionTrigger** `object` For convertibles to convert into the next equity round, terms may be included that specify that the round be of a certain size for the convertible to convert. - **canceledQuantity** `object` The quantity of shares in this convertible note that were canceled. - **nextPageToken** `string` Submit the `nextPageToken` string as `pageToken` in a subsequent request to retrieve the next page. If the `ListConvertibleNotes` response omits `nextPageToken`, then there are no subsequent pages. ### Example Request ```shell curl --request GET \ --url https://mock-api.carta.com/v1alpha1/investors/firms/firmId/funds/fundId/investments/investmentId/convertibleNotes \ --header 'accept: application/json' ``` ### Example Response ```json { "convertibleNotes": [ { "firmId": "0c481821-3bc8-42a5-94cd-a2c89d88429d", "firmName": "Krakatoa Ventures", "fundId": "6c26b46f-6515-4685-a438-9811c607788a", "fundName": "Krakatoa Ventures Fund I, L.P.", "companyId": "a44b42cb-d16a-4427-8dd2-d33083fb638a", "companyName": "Meetly", "currentStakeholderId": "7", "id": "1", "securityLabel": "CN-3", "issueDate": { "value": "2024-05-24" }, "conversionDate": { "value": "2024-05-24" }, "canceledDate": { "value": "2024-05-24" }, "cashPaid": { "currencyCode": { "value": "USD" }, "amount": { "value": "10000.0" } }, "maturityDate": { "value": "2024-05-24" }, "interest": { "currencyCode": { "value": "USD" }, "amount": { "value": "50.0" } }, "noteBlock": {"id": "4", "name": "Bridge 2014", "prefix": "CN", "noteType": "CONVERTIBLE_DEBT", "status": "EXECUTED" }, "interestAccrualPeriod": "INTEREST_ACCRUAL_PERIOD_MONTHLY_FIRST_OF_MONTH", "interestRate": { "value": "3.0" }, "interestCompoundingPeriod": "ANNUALLY", "dayCountBasis": "COUNT_ACTUAL_360", "priceCap": { "currencyCode": { "value": "USD" }, "amount": { "value": "12000.0" } }, "discountPercentage": { "value": "0.5" }, "changeInControlPercent": { "value": "0.5" }, "conversionTrigger": { "currencyCode": { "value": "USD" }, "amount": { "value": "500.0" } }, "canceledQuantity": { "value": "1000.0" } } ], "nextPageToken": "eyJwYWdlX3NpemUiOiAxMCwgImFzX29mX2RhdGUiOiAiMjAyNC0wNi0xMVQwMDowMDowMC4wMDAwMDBaIiwgImluZGV4IjogMCwgImlubmVyX3BhZ2VfdG9rZW4iOiAiZXlKc2FXMXBkQ0k2SURFd0xDQWliRzlqWVhScGIyNGlPaUF3TENBaWNYVmxjbmxmY21WeGRXVnpkRjlwWkNJNklDSXhNak5sTkRVMk55MWxPRGxpTFRFeVpETXRZVFExTmkwME1qWTJNVFF4TnpRd01EQWlmUT09IiwgImlubmVyX3BhZ2Vfb2Zmc2V0IjogMH0=" } ``` ### 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.