Aggregate Fundraising Stage History
POST/v1/fundraisings/stage-history/aggregate
Groups recorded stage transitions across every fundraising opportunity in the organization and returns counts per group — the funnel and pipeline-velocity counterpart to the per-opportunity Get Fundraising Stage History endpoint.
Group by one of the fields listed on group_by. Stage and user groups are returned with their display name as the group key and the raw id alongside (stageId / userId); an opportunity's creation row has no previous stage and groups under Fundraising created. Set group_by_granularity with group_by: ["changed_at"] to bucket transitions by day, week, month, quarter or year.
Set count_by to fundraisings to count distinct opportunities instead of transitions — required for a funnel or a conversion rate, so an opportunity that re-entered a stage is not counted twice.
History covers the stage changes the app recorded; older periods come from the activity history, may start later per tenant and merge very quick consecutive moves. An opportunity imported after recording began starts with its creation row; older imports have none.
Request
Responses
- 200
- 400
- 401
- 500
Aggregation results
Invalid request parameters
Invalid or missing API key
Internal server error