Skip to main content
Requires core scope The charities endpoints let you browse the full network of verified non-profits on Donate.gg. Use charity IDs from these endpoints when creating configs.

​
List charities

GET /charities Returns a paginated list of all verified charities with full metadata. 
curl https://www.donate.gg/api/v1/charities \
  -H "donate-api-key: YOUR_API_KEY"
Query parameters
ParameterTypeDefaultDescription
limitinteger50Results per page, max 200
cursorstring-Cursor from previous pageKey for next page
isEnabled"true" | "false"-Filter by enabled state. 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",
      "address": "431 18th St NW",
      "blog": "https://blog.redcross.org",
      "twitter": "RedCross",
      "facebook": "redcross",
      "instagram": "redcross",
      "linkedin": "RedCross",
      "youtube": "redcross",
      "city": "Washington",
      "state": "DC",
      "country": "US",
      "zipCode": "20006",
      "taxId": "53-0196605",
      "isEnabled": true,
      "isVerified": true
    }
  ]
}
Social fields (blog, twitter, facebook, instagram, linkedin, youtube) are string | null.

​
Search charities

GET /charities/search Search charities by name using fuzzy matching. Paginated. 
curl "https://www.donate.gg/api/v1/charities/search?term=red+cross" \
  -H "donate-api-key: YOUR_API_KEY"
Query parameters
ParameterTypeDefaultDescription
termstring-Required. Search term (non-empty)
limitinteger10Results per page, max 50
cursorstring-Cursor from previous pageKey for next page
Response (200) - same paginated charity shape as the list endpoint. Errors
StatusCodeDescription
400VALIDATION_ERRORMissing/empty term or term too short after normalisation

​
Get a charity by ID

GET /charities/{charityId} Returns a single charity by its ID with full metadata. 
curl https://www.donate.gg/api/v1/charities/charity_abc \
  -H "donate-api-key: YOUR_API_KEY"
Path parameters
ParameterDescription
charityIdThe charity’s ID
Response (200) - a single charity object in the same shape as items in the list endpoint. Error responses
StatusCodeDescription
404NOT_FOUNDNo charity found with the given ID