Documentation Index
Fetch the complete documentation index at: https://docs.donate.gg/llms.txt
Use this file to discover all available pages before exploring further.
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"
| Parameter | Type | Default | Description |
|---|
limit | integer | 50 | Results per page, max 200 |
cursor | string | - | Cursor from previous pageKey for next page |
isEnabled | "true" | "false" | - | Filter by enabled state. Omit to return all charities |
{
"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
}
]
}
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"
| 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 |
| 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 charity by its ID with full metadata.
curl https://www.donate.gg/api/v1/charities/charity_abc \
-H "donate-api-key: YOUR_API_KEY"
| Parameter | Description |
|---|
charityId | The charity’s ID |
| Status | Code | Description |
|---|
404 | NOT_FOUND | No charity found with the given ID |
