Charity API Documentation

Charity Basic API

Charity Basic

This documentation explains how to use the OrgHunter Charity API to retrieve detailed information on a specific charity. By providing the charity's EIN and your API key, you can access comprehensive data, including the organization's current IRS status. This method offers a streamlined way to provide your users with the essential information they need about a nonprofit, often eliminating the need for further API calls.

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 basic API provides detailed information on the charity including its current status with the IRS. In most cases, the charity basic API provide sufficient information to the end-user related a specific charity.

HTTP method

POST

Charity Basic API End Point

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

Request URL Example

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

cURL Example

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

Search Parameters

Parameter	Data Type	Required/Optional	Description
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

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" 
        }
}

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.