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

Signup for your API Key »

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

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

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

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)
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 - yyyymm
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.
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

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)
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 - yyyymm
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

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

OrgHunter API Portal »

API Documentation

Overview

Get Started

API Methods

Charity Search

HTTP method: POST

Search Parameters:

Response Values:

Categories

HTTP method: POST

Parameters:

Response Values:

Charity Basic

HTTP method: POST

Parameters:

Response Values:

Charity GeoLocation

HTTP method: POST

Parameters:

Response Values:

Charity Financial

HTTP method: POST

Parameters:

Response Values:

Charity Premium

HTTP method: POST

Parameters:

Response Values:

Common Error Codes:

Visit our API Portal

Forgot Your Password?

Change Password

API Documentation

Overview

Get Started

API Methods

Charity Search

HTTP method: POST

Search Parameters:

Response Values:

Categories

HTTP method: POST

Parameters:

Response Values:

Charity Basic

HTTP method: POST

Parameters:

Response Values:

Charity GeoLocation

HTTP method: POST

Parameters:

Response Values:

Charity Financial

HTTP method: POST

Parameters:

Response Values:

Charity Premium

HTTP method: POST

Parameters:

Response Values:

Common Error Codes:

Visit our API Portal

Charity Info

Owner Info

Donor Signup

User Sign in

Forgot Your Password?

Change Password