Skip to main content
GET
Donation KPIs
One call returns the whole month’s figures — no paging, no timeout risk. Date window is half-open [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

Authorization
string
header
required

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

date_from
string<date-time>

Only donations on or after this date (donation date, RFC 3339, inclusive).

date_to
string<date-time>

Only donations strictly before this date (exclusive). A calendar month is date_from=2026-04-01 & date_to=2026-05-01.

created_from
string<date-time>

Only donations created on or after this date (inclusive).

created_to
string<date-time>

Only donations created strictly before this date (exclusive).

amount_min
integer<int64>

Minimum donation amount in cents (inclusive).

Required range: x >= 0
amount_max
integer<int64>

Maximum donation amount in cents (inclusive).

Required range: x >= 0
contact_id
integer<int64>[] | null

Filter by one or more contact IDs.

Required range: x >= 0
donation_price_id
integer<int64>[] | null

Filter by one or more donation price IDs.

Required range: x >= 0

Response

OK

data
object
required
status
string
required

Operation result.

Example:

"success"

Last modified on July 7, 2026