Charity API Documentation | Summary Start Here

Charity Search Summary API - Start Here

Charity Search

This document outlines the powerful search capabilities of the OrgHunter Charity API. Leverage this functionality to build robust search experiences within your application, enabling users to efficiently locate IRS-registered nonprofits. Explore the available search parameters, learn how to implement pagination for streamlined results, and discover how to filter for eligible organizations. This API provides the tools you need to create dynamic and user-friendly charity search features.

This method enables you to search the entire database of IRS registered nonprofits. Use this API to return multiple charities based on user inputs such as an EIN, charity name, category, city, state, and ZIP Code. You can control the number of records that are returned and page position to implement Pagination. To filter out ineligible organizations simply pass the value eligible=1.

NEW GIS Support - The Charity Search Summary API now supports Longitude, Latitude and Distance. We are ready to support your GIS requirement and innovative Geo Location based applications and websites. Longitude and Latitude data available on 2.5M charities.

HTTP method

POST

Charity Search API End Point

http://data.orghunter.com/v1/charitysearch

Request URL Example

http://data.orghunter.com/v1/charitysearch?user_key=yourKey&searchTerm=treasure%20coast%20humane

cURL Example

curl -v -X POST "http://data.orghunter.com/v1/charitysearch?user_key=yourKey&searchTerm=treasure%20coast%20humane"

Search Parameters

Parameter	Data Type	Required/Optional	Description
user_key	string	required	Your API Key
ein	number	optional	Employer Identification Number (EIN)
searchTerm	string	optional	Charity Name or Keyword. Example: "humane society" or "cancer"
city	string	optional	City name. Example: "Miami"
state	string	optional	State name - Two-letter state abbreviation
zipCode	string	optional	Zipcode value - 5 digit zipcode value
form990_amount_min	numeric	optional	Form 990 amount - number only, no spaces, commas, or decimals. Returns records with revenue greater than or equal to an amount
form990_amount_max	numeric	optional	Form 990 amount - number only, no spaces, commas, or decimals. Returns records with revenue less than or equal to an amount
latitude	numeric	optional	Latitude value - longitude must be supplied along with a latitude value
longitude	numeric	optional	Longitude value - latitude must be supplied along with a longitude value
distance	numeric	optional	Longitude and latitude must be supplied when passing a distance value. Distance will be calculated in miles (10 mile maximum)
category	string	optional	Category Value Selected from Categories API, multiple values can be passed and separated by a coma
eligible	string	optional	eligible=1 will return only organizations that are tax-deductible and in good standing with the IRS
rows	number	optional	Records Per Page. Default Value = 20
start	number	optional	Record Set Start Position-Remove Me

Response Values:

The following values are returned

Name	Data Type	Description
ein	string	Employer Identification Number (EIN)
charityName	string	Charity Name
category	string	Category Description
url	string	URL Link to the OrgHunter.com Detail Page
city	string	Organization City
state	string	Organization State
zipCode	number	Organization Zip Code
website	string	Organization Website Address
missionStatement	string	Organization Mission Statement
longitude	string	Longitude Value
latitude	string	Latitude Value
acceptingDonations	string	Organization Accepts Donations 1=Yes, 0=No
start	number	Search Result Score
rows	number	Number of Records Requested
recordCount	number	Total Records Available
score	number	Search Result Score

Response Body Example

{
    "code": 200, 
    "msg": "OK, all went through!",
            "data": 
            { 
              "ein": "271742079",
              "charityName": "TREASURE COAST HUMAN RESOURCE ASSOCIATION INC",
              "category": "Community Improvement, Capacity Building",
              "url": "http://www.orghunter.com/organization/271742079",
              "donationUrl": "http://donate.makemydonation.org/donate/271742079",
              "eligibleCd": 1, "city": "VERO BEACH",
              "state": "Florida",
              "zipCode": "32961-2731",
              "deductibilityCd": 1, 
              "statusCd": 1, 
              "start": 0, "rows": 20, 
              "recordCount": 204, 
              "score": 8.947861, 
              "website": "www.somewebsite.com",
              "missionStatement": "Mission Statement Value",
              "acceptingDonations": 1 
            }
}

Common Codes

Description	Code
OK	200
Not Authorized	403
No Results Found	404
Server Error	500

When you visit or interact with our sites, services or tools, we or our authorized service providers may use cookies for storing information to help provide you with a better, faster and safer experience and for marketing purposes.