Aggregate LP Commitments
POST/v1/lp-discovery/commitments/aggregate
Total the LP→fund commitments of the shared Discovery catalogue (Global_LP_Fund_Commitments) by one field: each record is "this LP committed this much to this fund", joined to the LP, the fund and the fund's GP. Groups carry a count and, optionally, a sum, average, minimum or maximum of a number field. It is Carta-curated reference data, not the organization's own records.
The totals cover only the commitments the catalogue holds, so they are partial: never present them as a market total. The figures were reported at different as-of dates. Every amount is in USD; a commitment reported only in another currency has no USD amount, so the metric ignores it (it still counts toward count), and amounts are never converted. Each LP's commitment to a fund is counted once, using its latest report. Retired LPs, funds and GPs are left out.
count is the number of commitment records behind each total. Quote it with the figure, for example "$1.2B, based on 37 records".
A group by lpType also carries typeLabel, the type's display name, and a group by fundStrategy, gpStrategy or fundStrategyClass carries strategyLabel or strategyClassLabel. An avg is rounded to two decimals. Rank a "top" list by metricValue yourself.
Use this for questions like "how much did pension funds commit to 2020-vintage buyout funds?" (group_by lpType, filter vintage eq 2020 and fundStrategy eq buyout, metric commitmentUsd sum), "which LP types put the most into venture?" (group_by lpType, filter fundStrategy eq venture, metric commitmentUsd sum), "total European LP commitments per vintage" (group_by vintage, filter lpRegion eq Europe, metric commitmentUsd sum) or "top LPs by commitment to Blackstone funds" (group_by lpName, filter gpName eq the GP's catalogue name, metric commitmentUsd sum). 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/lp-discovery/commitments/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. Pass an lpId, gpId or fundId group to GET /v1/lp-discovery/:id, GET /v1/gp-discovery/:id or GET /v1/fund-discovery/:id for the record behind it. group_by_granularity is not supported: no commitment field is a date.
Request
Responses
- 200
- 400
- 401
- 500
Aggregation results
Invalid request parameters
Invalid or missing API key
Internal server error