orghunter logo
Charity API Key

Getting Started
Grant Processing
Home Page

Charity Basic API

Charity Basic

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
Charity Basic API End Point
Request URL Example
cURL Example
curl -v -X POST ""
Search Parameters
ParameterData TypeRequired/OptionalDescription
einstringrequiredEmployer Identification Number (EIN)
Response Values:
The following values are returned
NameData TypeDescription
einNumberEmployer Identification Number (EIN)
nameStringPrimary Name of Organization
inCareOfNameStringIn Care of Name
streetStringStreet Address
stateStringState - Full State Name
zipCodeStringZip Code
groupExemptionNumberGroup Exemption Number
subsectionStringSubsection Description
classificationStringClassification Description
affiliationStringAffiliation Description
rullingDate*StringRulling Date - Month, YYYY
deductibilityStringDeductibility Description
deductibilityStatusStringDeductibility Status Description
foundationStringFoundation Description
activity1StringActivity Codes Description
activity2StringActivity Codes Description
activity3StringActivity Codes Description
organizationStringOrganization Description
exemptStatusStringExempt Organization Status Description
taxPeriod*StringTax Period Description
assetCodeDescStringAsset Code Description
incomeCodeDescStringIncome Code Description
filingRequirementCodeDescStringFiling Requirement Code Description
pfFilingRequirementCodeDescStringPF Filing Requirement Code Description
accountingPeriod*StringAccounting Period Description
assetAmountStringAsset Amount
incomeAmountStringIncome Amount (includes negative sign if amount is negative)
form990StringForm 990 Revenue Amount (includes negative sign if amount is negative)
nteeCdStringNational Taxonomy of Exempt Entities (NTEE) Code
nteeClassStringNational Taxonomy of Exempt Entities (NTEE) Code
nteeTypeStringNational Taxonomy of Exempt Entities (NTEE) Code
sortNameStringSort Name (Secondary Name Line)
revocationDt*StringRevocation Date
revPostingDt*StringRevocation Posting Date
irsRevocationStatusNumberIf 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.
acceptingDonationsstringOrganization Accepts Donations 1=Yes, 0=No
Response Body Example
    "code": 200, 
    "msg": "OK, all went through!", 
          "ein": "271742079", 
          "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
Not Authorized403
No Results Found404
Server Error500

orghunter logo
© OrgHunter 2024. All rights reserved.

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.