DocsAPIInvestments

Update warrants

Updates warrants – including exercising them, by setting conversion_date and the capital deployed at exercise.

PATCH
/investments/warrants/{id}
Path

Investment ID

Example: 1

Body

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: 2026-06-15

Example: 2024-01-31

Example: 50000

Request Body

application/jsonOptional
datestring

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

expiration_datestring

Date the warrants expire

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

Date the warrants were exercised. Leave unset while they are outstanding.

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

Options and warrants still held by the fund

Path Parameters

idRequiredstring

Investment ID

Pattern: "^\\d+$"

Credentials

Bearer
curl -X PATCH "https://api.fundra.com/v1/investments/warrants/1" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "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,
    "expiration_date": "2026-06-15",
    "conversion_date": "2024-01-31",
    "options_held": 50000
  }'

Investment updated

{
  "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

Update secondary investmentPATCH

Next

Delete investmentDELETE