Charities

Public (API key optional) The charities endpoints let you browse Charity records on Donate.gg and filter by platform participation. Use charity IDs from these endpoints when creating configs. Anonymous callers may omit donate-api-key and are IP rate-limited; see Authentication. To watch for newly added charities, poll the listing feed. Search is a typeahead and is not a change feed.

List charities

GET /charities Returns a paginated list of charities with full metadata.

curl https://api.donate.gg/api/v1/charities

Query parameters

Parameter	Type	Default	Description
`limit`	integer	`50`	Results per page, max `200`
`cursor`	string	-	Cursor from previous `pageKey` for next page
`isEnabled`	`"true"` \| `"false"`	-	Compatibility filter derived from canonical Charity status. `true` means either active status; `false` means any non-public status. Omit to return all charities

Response

{
  "pageKey": "next_cursor_string",
  "response": [
    {
      "id": "charity_abc",
      "slug": "red-cross",
      "name": "American Red Cross",
      "logo": "https://...",
      "website": "https://redcross.org",
      "mission": "To prevent and alleviate human suffering...",
      "address": "431 18th St NW",
      "city": "Washington",
      "state": "DC",
      "country": "US",
      "zipCode": "20006",
      "taxId": "53-0196605",
      "socials": {
        "blog": "https://blog.redcross.org",
        "twitter": "RedCross",
        "facebook": "redcross",
        "instagram": "redcross",
        "linkedin": "RedCross",
        "youtube": "redcross",
        "blogUrl": "https://blog.redcross.org",
        "twitterUrl": "https://x.com/RedCross",
        "twitterHandle": "RedCross",
        "facebookUrl": "https://facebook.com/redcross",
        "facebookHandle": "redcross",
        "instagramUrl": "https://instagram.com/redcross",
        "instagramHandle": "redcross",
        "linkedinUrl": "https://linkedin.com/company/redcross",
        "linkedinHandle": "RedCross",
        "youtubeUrl": "https://youtube.com/@redcross",
        "youtubeHandle": "redcross",
        "youtubeChannelId": "UC..."
      },
      "isEnabled": true
    }
  ]
}

Social fields All social fields live under the nested socials object and are string | null.

Field	Notes
`blogUrl`, `twitterUrl`, `facebookUrl`, `instagramUrl`, `linkedinUrl`, `youtubeUrl`	Full profile or channel URLs
`twitterHandle`, `facebookHandle`, `instagramHandle`, `linkedinHandle`, `youtubeHandle`, `youtubeChannelId`	Platform handles or IDs
`blog`, `twitter`, `facebook`, `instagram`, `linkedin`, `youtube`	Deprecated. Kept for older clients. `blog` matches `blogUrl`. The rest match the matching handle field.

Recently listed charities

GET /charities/feed Newest enabled charities, one page of 50. listedAt is when the charity row was created. A charity appears here after it is added, whether US automation created it or an admin approved a request that created a new charity. Submitting a request does not list it. Restoring a charity that already existed does not move it to the top, because listedAt stays the original creation time. The response is cached on the CDN until a charity write revalidates it, the same way search is. Poll this URL instead of searching many terms. Send back ETag or Last-Modified and an unchanged feed answers 304. Last-Modified also moves when a charity is hidden, restored, renamed, or its slug changes, not only when a new charity is added.

curl https://api.donate.gg/api/v1/charities/feed

Response

{
  "response": [
    {
      "id": "charity_abc",
      "slug": "red-cross",
      "name": "American Red Cross",
      "listedAt": "2026-09-01T12:00:00.000Z",
      "url": "https://www.donate.gg/charities/red-cross"
    }
  ]
}

Full metadata stays on GET /charities/{charityId}.

Atom

GET /charities/feed.atom The same page as an Atom 1.0 feed (application/atom+xml) for feed readers. The feed author is donate.gg. Each entry’s id is tag:donate.gg,2026:charity:{id}, updated is listedAt, and the link is the public charity page.

curl https://api.donate.gg/api/v1/charities/feed.atom

Search charities

GET /charities/search Search charities by name or slug. Only enabled charities are returned. Paginated. This is a typeahead: term is required and results are relevance-ranked. It does not list newly added charities. Use GET /charities/feed for that.

curl "https://api.donate.gg/api/v1/charities/search?term=red+cross"

Query parameters

Parameter	Type	Default	Description
`term`	string	-	Required. Search term (non-empty)
`limit`	integer	`10`	Results per page, max `50`
`cursor`	string	-	Cursor from previous `pageKey` for next page

Response (200) - same paginated charity shape as the list endpoint. Errors

Status	Code	Description
`400`	`VALIDATION_ERROR`	Missing/empty `term` or term too short after normalisation

Get a charity by ID

GET /charities/{charityId} Returns a single enabled charity by its ID with full metadata. Disabled charities return 404.

curl https://api.donate.gg/api/v1/charities/charity_abc

Path parameters

Parameter	Description
`charityId`	The charity’s ID

Response (200) - a single charity object in the same shape as items in the list endpoint. Error responses

Status	Code	Description
`404`	`NOT_FOUND`	No enabled charity found with the given ID

List charity donations received

GET /charities/{charityId}/donations Paginated donations received by the charity.

curl "https://api.donate.gg/api/v1/charities/{charityId}/donations?limit=25"

List charity donation messages

GET /charities/{charityId}/donations/messages Paginated donations to the charity that include a message (useful for supporter walls).

curl "https://api.donate.gg/api/v1/charities/{charityId}/donations/messages?limit=25"

Getting Started

Developer

API

Blockchain

AI & LLMs

For Non-profits

Other

List charities

Recently listed charities

Atom

Search charities

Get a charity by ID

List charity donations received

List charity donation messages

​List charities

​Recently listed charities

​Atom

​Search charities

​Get a charity by ID

​List charity donations received

​List charity donation messages

List charities

Recently listed charities

Atom

Search charities

Get a charity by ID

List charity donations received

List charity donation messages