Skip to content

Get a user's public donation activity​

GET
/users/{id}/donation-activity

"Causes I support" on a public profile — the aggregate plus one entry per supported campaign. Accepts a UUID or a profile_slug; 404 only when the user does not exist.

Anonymous gifts are excluded, always. A profile that is private, or that has show_donations_on_profile off, answers zeroes. Only settled (paid) gifts count, and only to a campaign a reader could actually open — a deleted, draft, private, paused or unlisted campaign is neither listed nor counted (#1694).

Each entry in recent_supported_causes is a full campaign card, the same read model /fundraisers serves the /causes grid from, so the section renders the card the rest of the product uses. total_cents figures are INTEGER CENTS.

total_donated_cents is the PUBLIC figure and excludes anonymous gifts. It is the GIVER-FACING value of those gifts — the donation plus the platform tip, which is what the card was charged — so it agrees with the profile activity feed's per-gift figures and with the leaderboard's given figure. /donor/me/summary counts every gift the owner made and is a different number by design; do not compare them.

currency is the ISO 4217 code total_donated_cents is denominated in, taken from the donor's most recent gift that named one. Read it: minor units are not always hundredths, so formatting the total without it is a 100x error for a zero-decimal currency, not just the wrong symbol.

Authorizations​

BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type
HTTP (bearer)
or

Parameters​

Path Parameters

id*
Type
string
Required

Query Parameters

limit

Causes per page. The profile rail asks for 6; the dedicated page asks for more.

Type
integer
Minimum
1
Maximum
48
Default
6
offset
Type
integer
Minimum
0
Default
0

Responses​

User donation activity

application/json
JSON
{
"data": {
"total_donated_cents": 0,
"currency": "USD",
"causes_supported_count": 0,
"recent_supported_causes": [
{
}
],
"pagination": {
"limit": 0,
"offset": 0,
"total": 0
}
}
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

Built with VitePress