Charity API Premium Documentation

Charity Premium API

Charity Premium

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 Premium API is our most comprehensive and provides detailed information on the charity including its current status with the IRS. This API is an excellent option if you intend to include detailed financial information, financial charts and graphs along with detailed mapping information.

HTTP method

POST

Charity Premium API End Point

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

Request URL Example

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

cURL Example

curl -v -X POST "http://data.orghunter.com/v1/charitypremium?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.
latitude	String	Latitude Information
longitude	String	Longitude Information
totcntrbgfts	String	Total contributions
totprgmrevnue	String	Program service revenue
invstmntinc	String	Investment income
txexmptbndsproceeds	String	Tax-exempt bond proceeds
royaltsinc	String	Royalties
grsrntsreal	String	Gross rents -- Real estate
grsrntsprsnl	String	Gross rents -- Personal property
grsalesecur	String	Gross sales -- Securities
grsalesothr	String	Gross sales -- Other assets
grsincfndrsng	String	Gross fundraising
grsincgaming	String	Gross income from gaming
grsalesinvent	String	Gross sales of inventory
totrevenue	String	Total revenue
totfuncexpns	String	Total functional expenses
totassetsend	String	Total assets -- eoy
totliabend	String	Total liabilities -- eoy
totnetassetsend	String	Total Net Assets -- eoy
grntstogovt	String	Grants to governments/orgs in the US
grnsttoindiv	String	Grants to individuals in the US
grntstofrgngovt	String	Grants to orgs and individuals outside the US
benifitsmembrs	String	Benefits paid to or for members
compnsatncurrofcr	String	Compensation of current officers, directors, etc
compnsatnandothr	String	Compensation of disqualified persons
othrsalwages	String	Other salaries and wages
pensionplancontrb	String	Pension plan contributions
othremplyeebenef	String	Other employee benefits
payrolltx	String	Payroll taxes
feesforsrvcmgmt	String	Management fees
legalfees	String	Legal fees
accntingfees	String	Accounting fees
feesforsrvclobby	String	Lobbying fees
profndraising	String	Professional fundraising fees
feesforsrvcinvstmgmt	String	Investment management feed
feesforsrvcothr	String	Other fees
advrtpromo	String	Advertising and promotion
officexpns	String	Office expenses
infotech	String	Information technology
royaltsexpns	String	Royalties
occupancy	String	Occupancy
travel	String	Travel
travelofpublicoffcl	String	Travel/entertainment expenses to public officials
converconventmtng	String	Conferences, conventions, meetings
interestamt	String	Interest expense
pymtoaffiliates	String	Payments to affiliates
deprcatndepletn	String	Depreciation, depletion, amortization
insurance	String	Insurance
othrexpnsa	String	Other expenses 24a
othrexpnsb	String	Other expenses 24b
othrexpnsc	String	Other expenses 24c
othrexpnsd	String	Other expenses 24d
othrexpnse	String	Other expenses 24e
othrexpnsf	String	Other expenses 24f
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,
            "latitude": "27.690060",
            "longitude": "-80.412682",
            "totcntrbgfts": null,
            "totprgmrevnue": null,
            "invstmntinc": null,
            "txexmptbndsproceeds": null,
            "royaltsinc": null,
            "grsrntsreal": null,
            "grsrntsprsnl": null,
            "grsalesecur": null,
            "grsalesothr": null,
            "grsincfndrsng": null,
            "grsincgaming": null,
            "grsalesinvent": null,
            "totrevenue": null,
            "totfuncexpns": null,
            "totassetsend": null,
            "totliabend": null,
            "totnetassetsend": null,
            "grntstogovt": null,
            "grnsttoindiv": null,
            "grntstofrgngovt": null,
            "benifitsmembrs": null,
            "compnsatncurrofcr": null,
            "compnsatnandothr": null,
            "othrsalwages": null,
            "pensionplancontrb": null,
            "othremplyeebenef": null,
            "payrolltx": null,
            "feesforsrvcmgmt": null,
            "legalfees": null,
            "accntingfees": null,
            "feesforsrvclobby": null,
            "profndraising": null,
            "feesforsrvcinvstmgmt": null,
            "feesforsrvcothr": null,
            "advrtpromo": null,
            "officexpns": null,
            "infotech": null,
            "royaltsexpns": null,
            "occupancy": null,
            "travel": null,
            "travelofpublicoffcl": null,
            "converconventmtng": null,
            "interestamt": null,
            "pymtoaffiliates": null,
            "deprcatndepletn": null,
            "insurance": null,
            "othrexpnsa": null,
            "othrexpnsb": null,
            "othrexpnsc": null,
            "othrexpnsd": null,
            "othrexpnse": null,
            "othrexpnsf": 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 authorised service providers may use cookies for storing information to help provide you with a better, faster and safer experience and for marketing purposes.