Skip to main content
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 /developer/charities Returns a paginated list of all verified charities with full metadata and wallet addresses. 
curl https://www.donate.gg/api/v1/developer/charities \
  -H "donate-api-key: YOUR_API_KEY"
Query parameters
ParameterTypeDefaultDescription
limitinteger50Results per page, max 200
cursorstring-Cursor from previous pageKey for next page
Response 
{
  "pageKey": "next_cursor_string",
  "response": [
    {
      "id": "charity_abc",
      "configId": "0x118bc7170cd7ff78b9e06f0979630f4f0fa611bb6701bd759211b0b1bf3e9794",
      "slug": "red-cross",
      "name": "American Red Cross",
      "logo": "https://...",
      "website": "https://redcross.org",
      "address": "431 18th St NW",
      "city": "Washington",
      "state": "DC",
      "country": "US",
      "zipCode": "20006",
      "taxId": "53-0196605",
      "isEnabled": true,
      "isVerified": true
    }
  ]
}

​
Get a charity by ID

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