jolvAPI
jolv.app Open Jolv
API reference / Companies

Companies (directory)

Lists the organisation's companies (portfolio, pipeline, exits, holding companies) with identity, status, sector, country, pipeline stage, place in the structure and holding funds. Filters `status`, `fund_id`, `pipeline`; `updated_since` keeps only companies created or modified since that date; cursor pagination (`limit`, `cursor` → `next_cursor`). No amounts. Read-only.

GET/v1/list_companies

Query parameters

  • statusstringoptional
    Filter by company status (optional; e.g. active, exited, pipeline).
  • fund_iduuidoptional
    Keep only the companies held by this fund (optional).
  • pipelinebooleanoptional
    true: only pipeline opportunities (stage set); false: only companies outside the pipeline; omitted: all.
  • updated_sincestringoptional
    Only return items created or modified since this date (YYYY-MM-DD or ISO 8601 timestamp, optional).
  • limitintegeroptional
    Maximum number of companies per page (default 100, max 200).
  • cursorstringoptional
    Pagination cursor returned by the previous call (next_cursor), optional.

Response

Status 200, application/json. Resources outside your rights are absent, never an error.

  • companiesobject[]
    Show child attributes
    • company_idstring
    • namestring
    • short_namestring · nullable
    • jolv_refstring · nullable
    • statusstring · nullable
    • sectorstring · nullable
    • industrystring · nullable
    • countrystring · nullable
    • citystring · nullable
    • pipeline_stagestring · nullable
      Pipeline stage; null for a company outside the deal flow.
    • investment_asset_typestring · nullable
    • is_listedboolean
    • parent_idstring · nullable
      Parent tier in a HoldCo/OpCo chain.
    • chain_rolestring · nullable
    • investment_datestring · nullable
    • rejected_atstring · nullable
    • fundsobject[]
      Holding funds readable by the caller.
      Show child attributes
      • fund_idstring
      • fundstring · nullable
      • holding_statusstring · nullable
        Status of the holding line (active, exited…).
    • created_atstring · nullable
    • updated_atstring · nullable
  • next_cursorstring · nullable

Errors

400 invalid parameter · 401 missing or expired token · 429 too many requests · 500 read failed. See Errors.