Global Charity Verification API

Verify nonprofit organizations across multiple jurisdictions. Check registration status, search by name, and access detailed organization profiles. Data sourced from IRS (US), Charity Commission (UK), and DSD (South Africa).

Live

Base URL

https://api.crimate.net/v1/charity

Authentication

Include your Charity API key in the Authorization header.

curl -H "Authorization: Bearer db_charity_live_YOUR_KEY" \
     https://api.crimate.net/v1/charity/verify?registry_id=12-3456789

Endpoints

GET/v1/charity/verify

Check if a charity is registered and active by registry ID

Parameters: registry_id (required), jurisdiction (optional: us|uk|za)

Example

GET /v1/charity/verify?registry_id=12-3456789&jurisdiction=us

GET/v1/charity/search

Full-text search charities by name

Parameters: q (required), jurisdiction (optional), page, per_page

Example

GET /v1/charity/search?q=habitat+humanity&jurisdiction=us

GET/v1/charity/organizations/{id}

Full details for a specific organization

Parameters: id (path parameter)

Example

GET /v1/charity/organizations/12345

GET/v1/charity/jurisdictions

List all supported jurisdictions with registry info

Parameters: None

Example

GET /v1/charity/jurisdictions

GET/v1/charity/stats

Dataset statistics (total orgs, jurisdictions, last sync)

Parameters: None

Example

GET /v1/charity/stats

Response Examples

Verification response (found):

{
  "registry_id": "12-3456789",
  "verified": true,
  "name": "Habitat for Humanity International",
  "status": "active",
  "jurisdiction": "us",
  "jurisdiction_name": "United States",
  "category": "Housing",
  "city": "Atlanta",
  "state_province": "GA",
  "country": "US"
}

Verification response (not found):

{
  "registry_id": "00-0000000",
  "verified": false,
  "message": "Organization not found in our records."
}

Try It

Enter your Charity API key to make a live request. Generate a key in the dashboard.

Try It

Make a live API call from your browser

API Key

Endpoint

GET

curl -H "Authorization: Bearer db_charity_live_YOUR_KEY" \
     "https://crimate.net/v1/charity/stats"

Supported Jurisdictions

Code	Country	Registry	ID Format
us	United States	IRS	EIN (XX-XXXXXXX)
uk	United Kingdom	Charity Commission	Charity Number
za	South Africa	Dept. Social Development	NPO Number

Rate Limits

Tier	Price	Rate Limit	Daily Quota	Monthly Quota
Free	R0/mo	10 req/min	100	1,000
Starter	R499/mo	60 req/min	5,000	50,000

Error Codes

All error responses follow a consistent JSON format:

{
  "error": "error_code",
  "message": "Human-readable description."
}

Status	Error Code	Description
400	invalid_request	The request body or query parameters are malformed.
401	unauthorized	Missing or invalid API key.
403	no_subscription	No active subscription for this API product.
403	quota_exceeded	Daily or monthly quota exceeded.
404	not_found	The requested resource does not exist.
429	rate_limit_exceeded	Too many requests. Check X-RateLimit-Remaining header.
500	internal_error	An unexpected server error occurred.