financial_statements

Get a financial statement

Returns a single financial-statement workbook by ID, with its full parsed JSON body. The vehicle query parameter is required for authorization — the caller must have access to the vehicle the statement belongs to.

get/v1/financial_statements/{financial_statement_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: financial_statements:read

Path parameters

financial_statement_idstring required
Example:fnstmt_4kP9wL2nXyTaQ7vR

Unique identifier for the financial statement.

Query parameters

vehiclestring required
Example:vhcl_k9Rm3nQp8wL1YxTa

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

Response

The financial statement.

as_ofinteger nullable required

The date this financial statement is "as of" — the period-end date the workbook was generated for. Measured in seconds since the Unix epoch. Null when the upstream record lacks an as-of date.

bodyobject required

Parsed contents of the financial-statement workbook. Values are expressed in whole units of the fund's currency, not integer cents. The internal structure (sheet names, row shapes, cell values) is per-fund and may evolve; do not assume a fixed schema beyond "JSON object."

createdinteger required

Time at which the financial-statement record was created in the upstream system. Measured in seconds since the Unix epoch. Approximates the workbook's "as of" date for most statements but is the upstream record creation time, not a period-end date.

document_idstring nullable required

Public ID of the document backing this statement's workbook file. Pass it to getDocument for the file's metadata and a short-lived download URL, or to downloadDocument to stream the file bytes. Null when no backing document exists. Statement documents are only addressable this way; they do not appear in searchDocuments results.

idstring required

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

livemodeboolean required

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

object'financial_statement' required

Object type identifier.

period_type'interim' | 'closed' required

Whether this statement is for the current open period (interim) or a finalized, closed quarter (closed). Use closed rows for historical EOQ snapshots and interim for the latest in-progress period.

Example response

{
  "document_id": "doc_a1b2c3d4e5f6g7h8",
  "id": "fnstmt_4kP9wL2nXyTaQ7vR",
  "vehicle": {
    "id": "vhcl_k9Rm3nQp8wL1YxTa"
  }
}

Changes

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