API Documentation

API Documentation

Overview

Welcome to OrgHunter's Charity API documentation. The OrgHunter Charity API is an interface that allows you to incorporate realtime search results directly into your own application or website. Our database is updated daily to provide your platform with the most upto date and accurate charity information. You now have access to nearly 2 million charity records and over 10 million 990 images.

Get Started


API Methods

The following methods are currently available

  • Charity Search
  • Charity Detail
  • Categories

Charity Search

This method enables you to search the entire database of IRS registered nonprofits

HTTP method: POST


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

Search Parameters:

Parameter Data Type Required/Optional Description
user_key string required Your API Key
ein number optional Employer Identification Number (EIN)
searchTerm string optional Charity Name or Keyword. Example: "humane society" or "cancer"
city string optional city name. Example: "Miami"
state string optional state name - Two letter state abbreviation
zipCode string optional zipcode value - 5 digit zipcode value
category string optional Category Value Selected from Categories API
eligible string optional eligible=1 will return only organizations that are tax deductible and in good standing with the IRS
rows number optional Records Per Page. Default Value = 20
start number optional Record Set Start Position



Response Values:

The following values are returned

Available Fields
Name Data Type Description
ein string Employer Identification Number (EIN)
charityName string Charity Name
category string Category Description
url string URL Link to the OrgHunter.com Detail Page
city string Organization City
state string Organization State
zipCode number Organization Zip Code
start number Search Result Score
rows number Number of Records Requested
recordCount number Total Records Available
score number Search Result Score



Categories

This method enables you to provide a list of categories

HTTP method: POST


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

Parameters:

Parameter Data Type Required/Optional Description
user_key string required Your API Key



Response Values:

The following values are returned

Available Fields
Name Data Type Description
categoryId Number Category ID
categoryDesc string Category Description



Charity Basic

This method enables you to generate detailed information on a specific charity

HTTP method: POST


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

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

Available Fields
Name Data Type Description
ein Number Employer Identification Number (EIN)
nameStringPrimary Name of Organization
inCareOfNameStringIn Care of Name
streetStringStreet Address
cityStringCity
stateStringState - Full State Name
zipCodeStringZip Code
country*StringCountry
groupExemptionNumberGroup Exemption Number
subsectionStringSubsection Description
classificationStringClassification Description
affiliationStringAffiliation Description
rullingDate*StringRulling Date - yyyymm
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
filingRequirementCodeDesc StringFiling 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.



Charity GeoLocation

This method enables you to generate detailed information and GeoLocation on a specific charity.

HTTP method: POST


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

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

Available Fields
Name Data Type Description
ein Number Employer Identification Number (EIN)
nameStringPrimary Name of Organization
inCareOfNameStringIn Care of Name
streetStringStreet Address
cityStringCity
stateStringState - Full State Name
zipCodeStringZip Code
country*StringCountry
groupExemptionNumberGroup Exemption Number
subsectionStringSubsection Description
classificationStringClassification Description
affiliationStringAffiliation Description
rullingDate*StringRulling Date - yyyymm
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
filingRequirementCodeDesc StringFiling 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.
latitudeStringLatitude Information
longitudeStringLongitude Information



Charity Financial

This method enables you to generate detailed and financial information on a specific charity.

HTTP method: POST


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

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

Available Fields
Name Data Type Description
ein Number Employer Identification Number (EIN)
nameStringPrimary Name of Organization
inCareOfNameStringIn Care of Name
streetStringStreet Address
cityStringCity
stateStringState - Full State Name
zipCodeStringZip Code
country*StringCountry
groupExemptionNumberGroup Exemption Number
subsectionStringSubsection Description
classificationStringClassification Description
affiliationStringAffiliation Description
rullingDate*StringRulling Date - yyyymm
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
filingRequirementCodeDesc StringFiling 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.
totcntrbgftsStringTotal contributions
totprgmrevnueStringProgram service revenue
invstmntincStringInvestment income
txexmptbndsproceedsStringTax-exempt bond proceeds
royaltsincStringRoyalties
grsrntsrealStringGross rents -- Real estate
grsrntsprsnlStringGross rents -- Personal property
grsalesecurStringGross sales -- Securities
grsalesothrStringGross sales -- Other assets
grsincfndrsngStringGross fundraising
grsincgamingStringGross income from gaming
grsalesinventStringGross sales of inventory
totrevenueStringTotal revenue
totfuncexpnsStringTotal functional expenses
totassetsendStringTotal assets -- eoy
totliabendStringTotal liabilities -- eoy
totnetassetsendStringTotal Net Assets -- eoy
grntstogovtStringGrants to governments/orgs in the US
grnsttoindivStringGrants to individuals in the US
grntstofrgngovtStringGrants to orgs and individuals outside the US
benifitsmembrsStringBenefits paid to or for members
compnsatncurrofcrStringCompensation of current officers, directors, etc
compnsatnandothrStringCompensation of disqualified persons
othrsalwagesStringOther salaries and wages
pensionplancontrbStringPension plan contributions
othremplyeebenefStringOther employee benefits
payrolltxStringPayroll taxes
feesforsrvcmgmtStringManagement fees
legalfeesStringLegal fees
accntingfeesStringAccounting fees
feesforsrvclobbyStringLobbying fees
profndraisingStringProfessional fundraising fees
feesforsrvcinvstmgmtStringInvestment management feed
feesforsrvcothrStringOther fees
advrtpromoStringAdvertising and promotion
officexpnsStringOffice expenses
infotechStringInformation technology
royaltsexpnsStringRoyalties
occupancyStringOccupancy
travelStringTravel
travelofpublicoffclStringTravel/entertainment expenses to public officials
converconventmtngStringConferences, conventions, meetings
interestamtStringInterest expense
pymtoaffiliatesStringPayments to affiliates
deprcatndepletnStringDepreciation, depletion, amortization
insuranceStringInsurance
othrexpnsaStringOther expenses 24a
othrexpnsbStringOther expenses 24b
othrexpnscStringOther expenses 24c
othrexpnsdStringOther expenses 24d
othrexpnseStringOther expenses 24e
othrexpnsfStringOther expenses 24f



Charity Premium

This method enables you to generate detailed, GeoLocation and Financial information on a specific charity.

HTTP method: POST


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

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

Available Fields
Name Data Type Description
ein Number Employer Identification Number (EIN)
nameStringPrimary Name of Organization
inCareOfNameStringIn Care of Name
streetStringStreet Address
cityStringCity
stateStringState - Full State Name
zipCodeStringZip Code
country*StringCountry
groupExemptionNumberGroup Exemption Number
subsectionStringSubsection Description
classificationStringClassification Description
affiliationStringAffiliation Description
rullingDate*StringRulling Date - yyyymm
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
filingRequirementCodeDesc StringFiling 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.
latitudeStringLatitude Information
longitudeStringLongitude Information
totcntrbgftsStringTotal contributions
totprgmrevnueStringProgram service revenue
invstmntincStringInvestment income
txexmptbndsproceedsStringTax-exempt bond proceeds
royaltsincStringRoyalties
grsrntsrealStringGross rents -- Real estate
grsrntsprsnlStringGross rents -- Personal property
grsalesecurStringGross sales -- Securities
grsalesothrStringGross sales -- Other assets
grsincfndrsngStringGross fundraising
grsincgamingStringGross income from gaming
grsalesinventStringGross sales of inventory
totrevenueStringTotal revenue
totfuncexpnsStringTotal functional expenses
totassetsendStringTotal assets -- eoy
totliabendStringTotal liabilities -- eoy
totnetassetsendStringTotal Net Assets -- eoy
grntstogovtStringGrants to governments/orgs in the US
grnsttoindivStringGrants to individuals in the US
grntstofrgngovtStringGrants to orgs and individuals outside the US
benifitsmembrsStringBenefits paid to or for members
compnsatncurrofcrStringCompensation of current officers, directors, etc
compnsatnandothrStringCompensation of disqualified persons
othrsalwagesStringOther salaries and wages
pensionplancontrbStringPension plan contributions
othremplyeebenefStringOther employee benefits
payrolltxStringPayroll taxes
feesforsrvcmgmtStringManagement fees
legalfeesStringLegal fees
accntingfeesStringAccounting fees
feesforsrvclobbyStringLobbying fees
profndraisingStringProfessional fundraising fees
feesforsrvcinvstmgmtStringInvestment management feed
feesforsrvcothrStringOther fees
advrtpromoStringAdvertising and promotion
officexpnsStringOffice expenses
infotechStringInformation technology
royaltsexpnsStringRoyalties
occupancyStringOccupancy
travelStringTravel
travelofpublicoffclStringTravel/entertainment expenses to public officials
converconventmtngStringConferences, conventions, meetings
interestamtStringInterest expense
pymtoaffiliatesStringPayments to affiliates
deprcatndepletnStringDepreciation, depletion, amortization
insuranceStringInsurance
othrexpnsaStringOther expenses 24a
othrexpnsbStringOther expenses 24b
othrexpnscStringOther expenses 24c
othrexpnsdStringOther expenses 24d
othrexpnseStringOther expenses 24e
othrexpnsfStringOther expenses 24f



Common Error Codes:

The following values are returned

Error Explanation
200 OK
403 Not Authorized
404 No Results Found
500 Server Error



Visit our API Portal



User Sign in

Forgot Your Password?

Forgot Your Password?

Enter your email address and we'll send you a link to reset your password.

<< Back to sigin

Change Password

week good strong