Charity GeoLocation API

Charity GeoLocation

GeoLocation Charity API LogoThis method enables you to generate detailed information on a specific charity. This method accepts two parameters, your API key and the charity's EIN. The charity GeoLocation API provides detailed information on the charity including its current status with the IRS. This is an excellent option if you intend to include a Google maps widget within your application or website.

HTTP method:

POST

Charity GeoLocation API End Point

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

Request URL Example

http://data.orghunter.com/v1/charitygeolocation?user_key=yourKey&ein=590774235

cURL Example

curl -v -X POST "http://data.orghunter.com/v1/charitygeolocation?user_key=yourKey&ein=590774235"

Search Parameters:

Parameter Data Type Required/Optional Description
user_key string required Your API Key
ein string required Employer Identification Number (EIN)

Response Values:

The following values are returned
Name Data Type Description
ein Number Employer Identification Number (EIN)
name String Primary Name of Organization
inCareOfName String In Care of Name
street String Street Address
city String City
state String State - Full State Name
zipCode String Zip Code
country* String Country
groupExemption Number Group Exemption Number
subsection String Subsection Description
classification String Classification Description
affiliation String Affiliation Description
rullingDate* String Rulling Date - Month, YYYY
deductibility String Deductibility Description
deductibilityStatus String Deductibility Status Description
foundation String Foundation Description
activity1 String Activity Codes Description
activity2 String Activity Codes Description
activity3 String Activity Codes Description
organization String Organization Description
exemptStatus String Exempt Organization Status Description
taxPeriod* String Tax Period Description
assetCodeDesc String Asset Code Description
incomeCodeDesc String Income Code Description
filingRequirementCodeDesc String Filing Requirement Code Description
pfFilingRequirementCodeDesc String PF Filing Requirement Code Description
accountingPeriod* String Accounting Period Description
assetAmount String Asset Amount
incomeAmount String Income Amount (includes negative sign if amount is negative)
form990 String Form 990 Revenue Amount (includes negative sign if amount is negative)
nteeCd String National Taxonomy of Exempt Entities (NTEE) Code
nteeClass String National Taxonomy of Exempt Entities (NTEE) Code
nteeType String National Taxonomy of Exempt Entities (NTEE) Code
sortName String Sort Name (Secondary Name Line)
revocationDt* String Revocation Date
revPostingDt* String Revocation Posting Date
irsRevocationStatus Number If the status = 4 then the organization is on the IRS revocation file and not on the pub78 file. If the status = 1 then the organization is on the Pub78 file.
acceptingDonations string Organization Accepts Donations 1=Yes, 0=No
latitude String Latitude Information
longitude String Longitude Information

Response Body Example

{ "code": 200, "msg": "OK, all went through!", "data": { "ein": "271742079", "name": "TREASURE COAST HUMAN RESOURCE ASSOCIATION INC", "inCareOfName": "LAURIE COLLINGS", "street": "PO BOX 2731", "city": "VERO BEACH", "state": "FL", "zipCode": "32961-2731", "country": "USA", "groupExemption": null, "subsection": "501(c)(3)", "classification": "Charitable Organization", "affiliation": "Independent - This code is used if the organization is an independent organization or an independent auxiliary (i.e., not affiliated with a National, Regional, or Geographic grouping of organizations).", "rullingDate": "February, 2011", "deductibility": "Contributions are deductible.", "deductibilityStatus": "PC", "foundation": "Organization which receives a substantial part of its support from a governmental unit or the general public 170(b)(1)(A)(vi)", "activity1": null, "activity2": null, "activity3": null, "organization": "Corporation", "exemptStatus": "Unconditional Exemption", "taxPeriod": "December, 2014", "assetCodeDesc": "0", "incomeCodeDesc": "0", "filingRequirementCodeDesc ": "Not required to file (income less than $25,000)", "pfFilingRequirementCodeDesc": "No PF return", "accountingPeriod": "December", "assetAmount": "0.00", "incomeAmount": "0.00", "form990": "0.00", "nteeCd": "S03", "nteeClass": "Professional Societies, Associations", "nteeType": "Community Improvement, Capacity Building", "sortName": "", "revocationDt": null, "revPostingDt": null, "irsRevocationStatus": null, "acceptingDonations": "1", "latitude": "27.690060", "longitude": "-80.412682" } }

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!