Charity GeoLocation
This 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!
charity api: