Skip to main content

Aggregate Fund Catalogue

POST 

/v1/fund-discovery/aggregate

Group the funds of the shared Discovery fund catalogue by one field and count them, optionally with a sum, average, minimum or maximum of a number field per group. It is Carta-curated reference data, not the organization's own records.

irrMedianPct and tvpiMedian are each a median of the data points LPs reported for one fund, so avg over them is an average of per-fund medians, not an official benchmark. A fund with no value for the metric field is ignored by the metric (it still counts toward count), so a group where no fund has a value reports metricValue: 0, which does not mean a real zero: compare it with the group's count, and do not read it as a zero TVPI or IRR. avg is rounded to two decimals. Grouping by strategy or strategyClass also returns each group's strategyLabel or strategyClassLabel, the organization's name for the stored value that stays in _id. Groups of a number field (such as vintage or foundedYear) come back in ascending value order with the "Not specified" group last, ready to chart; groups of any other field come back largest first.

A field that needs Discovery Phase 4 answers 400 for an organization without it. Use GET /v1/fund-discovery/fields for the field ids and types; an unknown one is a 400. The values a field takes come from this endpoint with that field as group_by. group_by_granularity is not supported: no fund field is a date.

Request​

Responses​

Aggregation results