Donation KPIs
Return aggregate donation KPIs for the authenticated group(s) in a single request — no pagination. Yields donation count, unique donors, new donors (first-ever donors in the window), and totals per currency. Ideal for monthly reporting without iterating pages.
[date_from, date_to) — date_from inclusive, date_to exclusive — so a calendar month is date_from=2026-04-01&date_to=2026-05-01 (no last-day/last-millisecond math).
new_donors counts contacts whose first-ever donation falls in the window. Filter further with contact_id, donation_price_id, or amount_min/amount_max.Authorizations
OAuth2 access token. Pass the token in the Authorization header as Bearer <token>. The token is looked up in Redis to resolve the caller identity.
Query Parameters
Only donations on or after this date (donation date, RFC 3339, inclusive).
Only donations strictly before this date (exclusive). A calendar month is date_from=2026-04-01 & date_to=2026-05-01.
Only donations created on or after this date (inclusive).
Only donations created strictly before this date (exclusive).
Minimum donation amount in cents (inclusive).
x >= 0Maximum donation amount in cents (inclusive).
x >= 0Filter by one or more contact IDs.
x >= 0Filter by one or more donation price IDs.
x >= 0
