assets

Get an asset

Returns a single asset by ID. The vehicle query parameter is required for authorization — the caller must have access to the vehicle, and the asset must appear on that vehicle's most recent financial statement's schedule of investments.

Supported vehicle types: spv, ruv, venture_fund, and institutional_fund. Calls with a vehicle belonging to a rolling_fund_quarter return 404.

get/v1/assets/{asset_id}

Request

  • Base URL
    https://api.angellist.com
  • Auth
    OAuth 2
    Authorization code: https://gateway.angellist.com/oauth/authorize
    Client credentials
    Token URL: https://gateway.angellist.com/oauth/token scopes: assets:read

Path parameters

asset_idstring required
Example:asst_dascQ6ODbitSD6TMxYy7mTr1Diqw

Unique identifier for the asset.

Query parameters

vehiclestring required
Example:vhcl_k9Rm3nQp8wL1YxTa

Vehicle the asset belongs to. Required for authorization. Must be a vehicle of type spv, ruv, venture_fund, or institutional_fund.

Response

The asset.

date_purchasedinteger

Time at which the position was purchased. Measured in seconds since the Unix epoch. Omitted for rows where no purchase date was recorded.

idstring required

Unique identifier for this asset position. The underlying record id is encoded through a salted Sqid alphabet so the internal database identifier is never on the wire.

interest_rate_basis_pointsinteger

Stated interest rate of the instrument, in basis points (an 8% note is 800). Only present for interest-bearing instruments such as convertible notes.

investment_typestring

Instrument type of the position as recorded on the schedule of investments — e.g. Preferred Stock, SAFE, Convertible Note. Free-form text, not a closed enum. Omitted when no type was recorded.

last_valuation_action_dateinteger

Effective date of the most recent valuation applied to the position. Measured in seconds since the Unix epoch. Only present for actively held positions on the schedule of investments; omitted for fully realized positions and when the position has no recorded valuation.

livemodeboolean required

Whether this object exists in live mode (true) or test mode (false).

object'asset' required

Object type identifier.

remaining_sharesnumber double

Number of shares (or units) still held for the position. May be fractional. Omitted for positions without a share count — e.g. SAFEs and convertible notes.

Example response

{
  "accrued_interest": {
    "currency": "USD",
    "formatted": "$1,000,000.00"
  },
  "asset_class": {
    "id": "aclass_dascQ6ODbitSD6TMxYy7mTr1Diqw"
  },
  "asset_events": [
    {
      "portfolio_interest": {
        "currency": "USD",
        "formatted": "$1,000,000.00"
      },
      "realized_gain_loss": {
        "currency": "USD",
        "formatted": "$1,000,000.00"
      },
      "total_proceeds": {
        "currency": "USD",
        "formatted": "$1,000,000.00"
      }
    }
  ],
  "company": {
    "id": "cmpny_AJqi2An4xbPF2fbz3f9DZhVL8tDCH"
  },
  "id": "asst_1EFtUqAnmNk2n7w3yHhmllMrsvy0",
  "interest_rate_basis_points": 800,
  "investment_type": "Convertible Note",
  "remaining_cost_basis": {
    "currency": "USD",
    "formatted": "$1,000,000.00"
  },
  "remaining_shares": 1500,
  "unrealized_value": {
    "currency": "USD",
    "formatted": "$1,000,000.00"
  },
  "vehicle": {
    "id": "vhcl_k9Rm3nQp8wL1YxTa"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.