Skip to content

Donors​

A donor's own giving history, summary, and annual statements


Get donor summary​

GET
/donor/me/summary

Aggregate giving stats for the authenticated donor, anonymous gifts included. lifetimeAmountCents counts paid gifts only (no refunds or failures); the counts include every gift that left pending. A bare object.

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)

Responses​

Donor summary

application/json
JSON
{
"lifetimeAmountCents": 0,
"donationCount": 0,
"supportedFundraisers": 0,
"lastDonationAt": "string"
}

Playground​

Server
Authorization

Samples​


Get donor donation history​

GET
/donor/me/donations

Paginated giving history for the authenticated donor with optional filters.

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)

Parameters​

Query Parameters

page
Type
integer
Minimum
1
Default
1
limit
Type
integer
Minimum
1
Maximum
100
Default
20
year
Type
integer
status
Type
string
Valid values
"paid""refunded""failed""pending"
fundraiserId
Type
string
Format
"uuid"

Responses​

Donor donations, newest first

application/json
JSON
{
"data": [
{
"id": "string",
"fundraiser_id": "string",
"fundraiser_title": "string",
"fundraiser_slug": "string",
"amount_cents": 0,
"tip_amount_cents": 0,
"fee_amount_cents": 0,
"currency": "string",
"payment_status": "string",
"payment_intent_id": "string",
"is_anonymous": true,
"comment": "string",
"created_at": "string"
}
],
"pagination": {
"page": 0,
"limit": 0,
"total": 0,
"totalPages": 0
}
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​


Download annual giving statement​

GET
/donor/me/annual-statement

Generates a year-end giving summary for the authenticated donor as PDF or CSV (binary download). Includes only paid donations in the requested calendar year. Not a tax receipt.

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)

Parameters​

Query Parameters

year*

Calendar year. Between 2026 and the current year.

Type
integer
Required
Minimum
2026
format*
Type
string
Required
Valid values
"pdf""csv"

Responses​

Generated statement file

Playground​

Server
Authorization
Variables
Key
Value

Samples​


Powered by VitePress OpenAPI

Built with VitePress