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.

List charities

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

curl https://www.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.

Search charities

GET /charities/search Search charities by name or slug. Only enabled charities are returned. Paginated.

curl "https://www.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://www.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://www.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://www.donate.gg/api/v1/charities/{charityId}/donations/messages?limit=25"

Getting Started

Developer

API

Blockchain

AI & LLMs

For Non-profits

Other

List charities

Search charities

Get a charity by ID

List charity donations received

List charity donation messages

​List charities

​Search charities

​Get a charity by ID

​List charity donations received

​List charity donation messages

List charities

Search charities

Get a charity by ID

List charity donations received

List charity donation messages