DocsAPIInvestments

Add convertible investment

Records a convertible note, SAFE or venture debt. While it is outstanding only the convertible terms apply; once it converts, set conversion_date together with the share price and share counts it converted into.

POST
/investments/convertible
Body

Example: 10

Example: 2023-06-15

Example: 5

Example: Original

Example: 1000000

Example: USD

Example: 10.5

Example: preferred

Example: Series A

Example: 95238

Example: 190476

Example: 1190476

Example: 100000

Example: Lead

Example: false

Example: USD

Example: 500000

Example: 2000000

Example: 10000000

Example: pre-money

Example: 0.2

Example: 25000

Example: 2026-06-15

Example: 2024-01-31

Request Body

application/jsonOptional
portfolio_company_idRequiredstring

Portfolio company the investment belongs to (required) – this is what ties the investment to a fund

Pattern: "^\\d+$"
dateRequiredstring

Date of the investment – when the shares were registered, or the contribution paid in

Pattern: "^\\d{4}-\\d{2}-\\d{2}$"
funding_round_idstring

Funding round the investment was made in. Leave unset for transactions struck outside a round.

Pattern: "^\\d+$"
investment_typestring

Whether this is the fund's first cheque or a follow-on

Value in: "Original" | "Follow-on"
invested_capitalnumber

Capital invested, in the fund's currency

investment_costsarray<object>

Transaction costs booked against the deal

cashflowsarray<object>

How the invested capital was paid in. Must add up to invested_capital.

fieldsobject

Custom fields

currencystring

ISO 4217 currency of the share price

Minimum length: 3Maximum length: 3
share_pricenumber

Price per share

share_typestring

Share type acquired

Value in: "preferred" | "common"
share_classstring

Share class acquired

shares_acquiredinteger

Shares acquired by the fund

shares_issuedinteger

Total shares issued in the round

shares_outstandinginteger

Shares outstanding after the transaction, fully diluted

esopinteger

Shares reserved for the option pool

funds_rolestring

The fund's role in the round

Value in: "Lead" | "Co-lead" | "Syndicate"
is_internal_roundboolean

Whether the round was led by existing investors only

convertible_currencystring

ISO 4217 currency the convertible is denominated in

Minimum length: 3Maximum length: 3
convertible_valuenumber

The fund's share of the convertible, in the convertible's currency

convertible_totalnumber

Total size of the convertible, including other investors

convertible_capnumber

Valuation cap. Leave unset for an uncapped note.

convertible_cap_typestring

Whether the cap is stated pre- or post-money

Value in: "pre-money" | "post-money"
convertible_discountnumber

Conversion discount, as a fraction (0.2 = 20%)

Minimum: 0Maximum: 1
convertible_interestnumber

Capitalised interest converted into shares

expiration_datestring

Maturity date of the note

Pattern: "^\\d{4}-\\d{2}-\\d{2}$"
conversion_datestring

Date the note converted. Leave unset while it is still outstanding – the share fields only apply once it has converted.

Pattern: "^\\d{4}-\\d{2}-\\d{2}$"

Credentials

Bearer
curl -X POST "https://api.fundra.com/v1/investments/convertible" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "portfolio_company_id": "10",
    "date": "2023-06-15",
    "funding_round_id": "5",
    "investment_type": "Original",
    "invested_capital": 1000000,
    "investment_costs": [
      {
        "date": "2023-06-15",
        "amount": 1000000
      }
    ],
    "cashflows": [
      {
        "date": "2023-06-15",
        "amount": 1000000
      }
    ],
    "fields": {
      "property1": null,
      "property2": null
    },
    "currency": "USD",
    "share_price": 10.5,
    "share_type": "preferred",
    "share_class": "Series A",
    "shares_acquired": 95238,
    "shares_issued": 190476,
    "shares_outstanding": 1190476,
    "esop": 100000,
    "funds_role": "Lead",
    "is_internal_round": false,
    "convertible_currency": "USD",
    "convertible_value": 500000,
    "convertible_total": 2000000,
    "convertible_cap": 10000000,
    "convertible_cap_type": "pre-money",
    "convertible_discount": 0.2,
    "convertible_interest": 25000,
    "expiration_date": "2026-06-15",
    "conversion_date": "2024-01-31"
  }'

Investment created

{
  "data": {
    "id": "1",
    "uuid": "V1StGXR8",
    "portfolio_company_id": "10",
    "funding_round_id": "5",
    "instrument_type": "primary",
    "date": "2023-06-15",
    "investment_type": "Original",
    "funds_role": "Lead",
    "invested_capital": 1000000,
    "currency": "USD",
    "share_price": 10.5,
    "share_price_discount": 0.1,
    "share_type": "preferred",
    "share_class": "Series A",
    "shares_acquired": 95238,
    "shares_issued": 190476,
    "shares_outstanding": 1190476,
    "esop": 100000,
    "options_held": 0,
    "is_internal_round": false,
    "expiration_date": "2026-06-15",
    "conversion_date": "2024-01-31",
    "convertible_currency": "USD",
    "convertible_value": 500000,
    "convertible_total": 2000000,
    "convertible_cap": 10000000,
    "convertible_cap_type": "pre-money",
    "convertible_discount": 0.2,
    "convertible_interest": 25000,
    "investment_costs": [
      {
        "date": "2023-06-15",
        "amount": 1000000
      }
    ],
    "cashflows": [
      {
        "date": "2023-06-15",
        "amount": 1000000
      }
    ],
    "fields": {
      "property1": null,
      "property2": null
    },
    "created_at": "2023-06-16T10:30:00Z",
    "updated_at": "2023-06-20T14:45:00Z"
  }
}

Previous

Add capital contributionPOST

Next

Add primary investmentPOST