Skip to main content
GET
List donations
Query donations directly without fetching whole bundles. Date range: date_from/date_to (donation date) or created_from/created_to. Contacts / prices: repeat or comma-separate contact_id and donation_price_id. Each donation carries amount (cents) and contact_id, so monthly totals and unique-donor counts are a direct sum/dedupe over one page set.

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

limit
integer<int64>
default:20

Maximum number of items to return.

Required range: 1 <= x <= 1000
offset
integer<int64>
default:0

Number of items to skip.

Required range: x >= 0
date_from
string<date-time>

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

date_to
string<date-time>

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

created_from
string<date-time>

Only donations created on or after this date (RFC 3339).

created_to
string<date-time>

Only donations created on or before this date (RFC 3339).

amount_min
integer<int64>

Minimum amount in cents (inclusive).

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

Maximum amount in cents (inclusive).

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

Filter by one or more contact IDs (repeat or comma-separate).

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

Filter by one or more donation price IDs. See GET /v1/donation_prices.

Required range: x >= 0
sort
enum<string>
default:date

Sort column.

Available options:
created_at,
date,
amount
order
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc

Response

OK

data
object[] | null
required
status
string
required

Operation result.

Example:

"success"

total
integer<int64>
required

Total number of matching items.

Last modified on July 7, 2026