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
- 200
- 400
- 401
- 404
- 500
Aggregation results
The body is invalid, or the write is refused as it stands
Invalid or missing API key
LP Discovery or Discovery Phase 4 is off for the organization, or the id is unknown
Internal server error