Charity API Docs
CharityQuery is a developer API for searching IRS nonprofit data across the United States. Use it to find nonprofits by location, classification, financial attributes, and IRS metadata, then request only the fields your application needs.
curl "https://api.charityquery.com/nearby?origin_zip=28403&radius=25&fields=ein,name,city,state,ntee_group,distance_miles&limit=2" \
-H "x-api-key: YOUR_API_KEY"The /nearby endpoint finds nonprofits within a radius of a ZIP code or latitude/longitude pair. Results are sorted by distance_miles by default.
How CharityQuery works
Most requests follow the same pattern: choose an endpoint, filter the results, select the fields you want, and paginate through the response.
Search by location, IRS classification, NTEE code, deductibility, financial ranges, geocode status, and more.
Use the fields parameter to return only the data your app needs, such as ein, name, ntee_code, or distance_miles.
Many IRS-coded values return both the original code and a human-readable description.
Core endpoints
/nearby?origin_zip=28403&radius=25/charities?state=NC&fields=ein,name,ntee_code&limit=25Guides
Quickstart
Make your first API request and understand the response.
Auth & Limits
Use API keys and understand request limits.
Nearby Search
Find nonprofits near a ZIP code or latitude/longitude pair.
Filtering & Sorting
Filter by IRS fields, location, financial ranges, and more.
Field Selection
Request only the response fields your app needs.
Response Format
Understand enriched coded fields and response objects.
Metadata & Codes
Reference IRS code definitions used by CharityQuery.
Error Handling
Review validation, auth, rate limit, and server errors.