Charity Search Summary API - Start Here

Charity Search

Charity Search Summary API LogoThis 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.2M 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
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

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
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": "", "missionStatement": "", "acceptingDonations": 1 }

Common Codes

The following values are returned
  • 200 OK
  • 403 Not Authorized
  • 404 No Results Found
  • 500 Server Error

 

I have seen enough - Sign Me Up!