CharityNavigator Documentation

CharityNavigatorDataAPI (https://api.data.charitynavigator.org/v2)

The Charity Navigator Data API provides access to Charity Navigator's ratings, research content and charitable organization profiles.

OrganizationCollection `Organizations` `OrganizationSummary`

The full collection of organizations in Charity Navigator. Allows paged retrieval, simple and advanced searching.

Resource Properties

Media Types	application/json

Data Properties

Name	Type	Documentation
ein	string!	The federal Employer Identification Number for the charitable organization. May be set to a system-assigned value in cases where the organization is fictitious, or the real EIN is not available.
orgID	integer	Internal identifier assigned by Charity Navigator. Only rated charities have an orgID.
charityName	string	Name of the charitable organization.
tagLine	string	Tagline describing the charity.
websiteURL	anyURI	URL of the organization's website.
charityNavigatorURL	anyURI
mission	string	The organization's mission statement.
currentRating	Rating	Current rating for the organization.
ratingID	string	Unique identifier for this Rating.
score	decimal	Overall score, out of a possible 100, based on a two-dimensional analysis of financial health and accountability. Learn More
rating	int	Overall rating, on a four-star scale, based on a two-dimensional analysis of financial health and accountability. Learn More
publicationDate	date	Date the Rating was published
financialRating	FinancialRating	Financial Score, Rating, and performance metrics.
score	decimal	Overall financial score, out of a possible 100, based on a set of individual measures of financial health. Learn More
rating	int	Overall financial rating, on a four-star scale. Learn More
accountabilityRating	AccountabilityRating	Accountability and Transparency Score, Rating, and test indicators.
score	decimal	Overall accountability score, out of a possible 100, based on a set of individual measures of accountability and transparency. Learn More
rating	int	Overall accountability and transparency rating, on a four-star scale. Learn More
ratingImage	IconSet	URLs to retrieve a star rating images for this Rating
small	anyURI
large	anyURI
form990	Form990	Financial disclosures reported on the organization's IRS Form 990.
fundraisingExpenses	decimal	Fundraising expenses as reported on the income statement for the rating period. This measure reflects what a charity spends to raise money. Fundraising expenses can include campaign printing, publicity, mailing, and staffing and costs incurred in soliciting donations, memberships, and grants. Learn More
administrativeExpenses	decimal	Administrative expenses as reported on the income statement for the rating period. This measure reflects what percent of its total budget a charity spends on overhead, administrative staff and associated costs, and organizational meetings. Learn More
programExpenses	decimal	Program expenses as reported on the income statement for the rating period. This measure reflects what a charity spends to raise money. Fundraising expenses can include campaign printing, publicity, mailing, and staffing and costs incurred in soliciting donations, memberships, and grants. Learn More
totalExpenses	decimal	Total functional expenses, computed as the sum of program expenses, administrative expenses and fundraising expenses, as reported on the income statement for the rating period.
totalRevenue	decimal	Total revenue, as reported on the income statement for the rating period. Charities can derive revenue or funding from a variety of sources, including contributions, program services, membership dues, interest on savings, investment income, special events, and sales of inventory.
totalNetAssets	decimal	Total net assets, computed as he difference between assets and liabilities, as reported on the organization's financial statement for the rating period. Although charities do not exist to make money, they do work to build and maintain reasonable reserves of net assets. Growing its net assets helps a charity outpace inflation and sustain future program activities. Learn More
totalContributions	decimal	Total contributions is the sum of all contributions - including gifts, and grants, federated campaigns, membership dues, fundraising events, related organizations, and government grants.
primaryRevenue	decimal	The revenue a charity generates as a result of the work it does. A charity's primary revenue includes grants and contributions, revenue produced from programs and services, and membership fees and dues. Learn More
otherRevenue	decimal	In addition to primary revenue sources, charities derive revenue from investments, rents, special events, sales of inventory, and other unrelated business income. Learn More
ceoCompensationPercent	decimal	Based on the data found in each charity's most recently filed Form 990, we include salary, cash bonuses, and expense accounts when we measure a CEO's compensation. We do not include contributions to benefit plans or deferred compensation that is allocated to be paid in later years. Deferred compensation is often accrued over many years and then is paid as a lump sum in one year. As such, we do include deferred compensation as part of the compensation figure in the year in which it is actually paid out to the employee and/or when it is expensed per the 990. Many charities use fiscal years that differ from the calendar year. In these cases, it is important to recognize that the CEO’s compensation reported on the Form 990 reflects the CEO’s pay for the calendar year, not the fiscal year. Why? Because the IRS requires that charities report compensation on the Form 990 exactly the same as they did on the W-2 Form (which is based on the calendar year). Many donors are understandably interested in how much the leaders of charities earn. This information is public record so Charity Navigator reports it for our users. This information does not factor into an organization's Charity Navigator rating. We provide this percentage so donors can quickly put the salary into perspective. For comparative purposes, a charity with total expenses of $20 million, which compensates its highest paid executive at $200,000 per year (or 1%) would appear to have tighter control on expenses than the $1 million organization which pays its chief executive the same amount (or 20% of expenses for one person). Learn More
category	Category	The primary category of this organization's charitable work as assigned by Charity Navigator.
categoryID	string	Charity Navigator's unique identifier for the category.
categoryName	string	Name of the category.
cause	Cause	The primary cause of this organization's charitable work as assigned by Charity Navigator.
causeID	string	Charity Navigator's unique identifier for the cause.
causeName	string	Name of the cause.
irsClassification	IRSClassification	The classification and tax treatment of the Organization by the Internal Revenue Service.
subsection	string	A subsection in the tax code which defines the category under which an organization may be exempt from taxes.
foundationStatus	string	IRS classification of type of foundation. This is only applicable to 501(c)(3) Foundations.
deductibility	DeductibilityType	Specifies whether donations to this organization are tax-deductible.
deductibilityDetail	string	Provides more information when deductibility is NOT_DEDUCTIBLE_GENERALLY, indicating that donations to an organization are not generally deductible.
deductibilityCode	string	IRS Code to specify whether donations to this organization are tax-deductible.
nteeCode	string	The IRS's full classification code for the type of work this Organization performs
nteeClassification	string	The IRS's text description of the work that this Organization performs which corresponds to the full NTEECode
nteeLetter	string	Within the IRS's classification system, the first letter of the code represents broad subsectors, such as health, education, and youth development, of the charitable organization universe.
nteeType	string	The IRS's text description of the NTEE Letter portion of this this organizations classification
nteeSuffix	string	The last and optional character in the IRS classification system
affiliation	string	affiliation
groupName	string	groupName
exemptOrgStatus	string	exemptOrgStatus
exemptOrgStatusCode	string	exemptOrgStatusCode
rulingDate	string	rulingDate
assetAmount	string	assetAmount
incomeAmount	string	incomeAmount
latest990	string	latest990
filingRequirement	string	filingRequirement
accountingPeriod	string	accountingPeriod
classification	string	classification
mailingAddress	Address	Mailing address of the organization.
streetAddress1	string	First line of the street address.
streetAddress2	string	Second line of the street address.
city	string	City.
stateOrProvince	string	State or province.
postalCode	string	Postal code.
country	string	Country. Note that Charity Navigator currently covers only organizations based in the United States. If the Country is null, empty, or missing, it is safe to assume a US-based address.
donationAddress	Address	Address to send donations to the organization.
streetAddress1	string	First line of the street address.
streetAddress2	string	Second line of the street address.
city	string	City.
stateOrProvince	string	State or province.
postalCode	string	Postal code.
country	string	Country. Note that Charity Navigator currently covers only organizations based in the United States. If the Country is null, empty, or missing, it is safe to assume a US-based address.
advisories	AdvisoryRollup	Advisories related to the organization that are currently in effect.
severity	Severity	Rolled up severity level of all active advisory records for the organization. A NULL value means there are no active advisory records
active	AdvisoryCollection	Reference to all active advisory records for an organization.
organization	OrganizationObject	Link to the organization resource, with all available details.
ein	string!	The federal Employer Identification Number for the charitable organization. May be set to a system-assigned value in cases where the organization is fictitious, or the real EIN is not available.
charityName	string	Name of the charitable organization.

GET searchOrganizations

Retrieve a list of the organizations available in the Charity Navigator Data Store. Allows paged retrieval, simple and advanced searching.

Request

Parameters

Name Documentation Default Property Type

app_id

3Scale App ID: unique identifier for an application registered in the Charity Navigator developer portal.

string

app_key

3Scale App Key: a secret key to authenticate the assigned App ID.

string

pageSize (optional)

Number of organizations to return in a single response message. Used in combination with pageNum for paged responses. Default value is 100. If specified, must be an integer value between 1 and 1,000.

100

int

pageNum (optional)

Page number to return, in case the number of available objects in the result set is greater than the specified or default pageSize. Default value is 1. If the value of pageNum is greater than the number of pages in the result set, the method will return a 404 error. If the requested starting position, computed as ((pageNum-1) * pageSize) + 1, is greater than the maximum supported result size of 10,000 objects, the method will return a 400 error.

integer

search (optional)

A simple search string that narrows the results to organizations matching the specified search terms. This is a relevance-driven search, not an exact match. Whitespace-separated terms in the search string are combined using AND logic, so adding terms has the effect of narrowing the search. By default, the search looks for matches in all string or text properties. The searchType parameter can change the field values included in the search.

string

searchType (optional)

Used in combination with the search parameter, specifies the type of search to be performed.

Value	Search Behavior
DEFAULT	Search in all string properties.
NAME_ONLY	Search only in the Organization name.

Omitting the searchType parameter has the same effect as specifying "DEFAULT".

Any value other than the ones specified in the table above will cause an HTTP 400 error response.

DEFAULT

string

rated (optional)

Specifies whether to include only rated charities or unrated charities. By default, all charities will be returned.

Can be specified as TRUE or FALSE, 0 or 1, or included without a value, which is equivalent to TRUE or 1.

Usage	Search Behavior
`rated=TRUE` `rated=1` `rated`	Return only rated charities.
`rated=FALSE` `rated=0`	Return only unrated charities.
(default)	Return all charities.

Any value other than the ones specified in the table above will cause an HTTP 400 error response.

boolean

categoryID (optional)

ID of a Category. Search results will be filtered to include only organizations in the specified category.

string

causeID (optional)

ID of a Cause. Search results will be filtered to include only organizations in the specified cause.

string

fundraisingOrgs (optional)

Specifies whether to include or exclude organizations flagged by Charity Navigator as fundraising organizations. By default, all charities will be returned.
[Learn More](javascript:openBrWindow('http://www.charitynavigator.org/index.cfm?bay=glossary.word&gid=95&print=1','glossary','scrollbars=yes,width=760,height=400')

Can be specified as TRUE or FALSE, 0 or 1, or included without a value, which is equivalent to TRUE or 1.

Note that a charity that has a "Moderate" or "High" Severity Advisory has its rating superseded by the Advisory and will not show up with the rated filter on. A rated charity with "Low" Severity Advisory is still considered rated and will still be found with the filter on.

Usage	Search Behavior
`fundraisingOrgs=TRUE` `fundraisingOrgs=1` `fundraisingOrgs`	Return only fundraising organizations.
`fundraisingOrgs=FALSE` `fundraisingOrgs=0`	Return only charities that are not fundraising organizations.
(default)	Return all charities.

Any value other than the ones specified in the table above will cause an HTTP 400 error response.

boolean

state (optional)

If set to a valid 2-letter state code (not case-sensitive), filters search results to include only organizations in the specified state. An invalid state code will respond with a 400 error.

string

city (optional)

Filters search results to include only organizations in cities whose names match the specified string. This uses fuzzy matching, and the city name may be given as a partial string.

string

zip (optional)

Filters search results to include only organizations in the specified zip code.

string

minRating (optional)

Filters search results to include only organizations with a rating greater than or equal to the specified value. Must be an integer value betwen 0 and 4, inclusive. Must be less than or equal to maxRating, if specified.

int

maxRating (optional)

Filters search results to include only organizations with a rating less than or equal to the specified value. Must be an integer value betwen 0 and 4, inclusive. Must be greater than or equal to minRating, if specified.

int

sizeRange (optional)

Filters search results to include only organizations within a given size bracket, as measured in annual Total Expenses. possible values include:

Value	Range
1	Up to $3.5MM
2	$3.5MM to $13.5MM
3	$13.5MM and up

int

donorPrivacy (optional)

Specifies whether to include or exclude organizations that have a donor privacy policy. By default, all charities are included, regardless of donor privacy policy.

Can be specified as TRUE or FALSE, 0 or 1, or included without a value, which is equivalent to TRUE or 1.

Usage	Search Behavior
`donorPrivacy=TRUE` `donorPrivacy=1` `donorPrivacy`	Return only organizations that have a donor privacy policy.
`donorPrivacy=FALSE` `donorPrivacy=0`	Return only organizations that do not have a donor privacy policy.
(default)	Return all charities.

Any value other than the ones specified in the table above will cause an HTTP 400 error response.

boolean

scopeOfWork (optional)

Filters search results to include only organizations with a given scope of work. Possible values are "ALL" (the default), "REGIONAL", "NATIONAL", or "INTERNATIONAL"

ALL

int

cfcCharities (optional)

Specifies whether to include or exclude organizations that are included in the Combined Federal Campaign, the largest workplace giving campaign in USA. By default, all organizations are included.
Learn More

Can be specified as TRUE or FALSE, 0 or 1, or included without a value, which is equivalent to TRUE or 1.

Usage	Search Behavior
`cfcCharities=TRUE` `cfcCharities=1` `cfcCharities`	Return only CFC charities.
`cfcCharities=FALSE` `cfcCharities=0`	Return only non-CFC charities.
(default)	Return all charities.

Any value other than the ones specified in the table above will cause an HTTP 400 error response.

boolean

noGovSupport (optional)

Specifies whether to include or exclude organizations that do not receive government support. By default, all organizations are included.

Can be specified as TRUE or FALSE, 0 or 1, or included without a value, which is equivalent to TRUE or 1.

Usage	Search Behavior
`noGovSupport=TRUE` `noGovSupport=1` `noGovSupport`	Return only charities that do not receive government support.
`noGovSupport=FALSE` `noGovSupport=0`	Return only charities that receive government support.
(default)	Return all charities.

Any value other than the ones specified in the table above will cause an HTTP 400 error response.

boolean

sort (optional)

Specifies how results should be sorted. By default, results are sorted by increasing ein value unless a search string is specified, in which case results are sorted by decreasing relevance to the search string.

This parameter takes the form of a sort property and an optional direction indicator, separated by a colon. E.g. NAME or NAME:ASC.

Sort property can be any of the following (examples indicate default direction):

Property	Example	Sort Behavior
`NAME`	`sort=NAME:ASC`	Sort alphabetically by charity name
`RATING`	`sort=RATING:DESC`	Sort numerically by overall ratings score. Implies `rated=true`.
`RELEVANCE`	`sort=RELEVANCE:DESC`	Sort numerically by search relevance score

Currently only one sort property is allowed.

Any of the following usages will result in an HTTP 400 error response:

Sort field is not one of the values listed above.
Sort direction is provided and is neither ASC nor DESC.
Sort field is RATING and rated=false is also specified.
Sort field is RELEVANCE and the search parameter is not specified.

string

Response OrganizationCollection 200
Successful response, with a list of Organizations.

Response ErrorInfo 400

Data Properties

Name	Type	Documentation
errorMessage	string

Invalid request. The ErrorInfo object should contain additional details.

Response ErrorInfo 404

Data Properties

Name	Type	Documentation
errorMessage	string

Not found. This means there is no data that satisfies the request criteria, Or the specified pageNum is greater than the number of pages of data returned from the request query.

OrganizationObject `Organizations/{ein}` `Organization` Default

Represents a single Organization in Charity Navigator.

Resource Properties

Media Types	application/json
Link Descriptors	OrganizationLink (`ein`, `charityName`) Default

Parameters

Name	Documentation	Default	Property	Type
ein			ein	string

Data Properties

Name	Type	Documentation
ein	string!	The federal Employer Identification Number for the charitable organization. May be set to a system-assigned value in cases where the organization is fictitious, or the real EIN is not available.
orgID	integer	Internal identifier assigned by Charity Navigator. Only rated charities have an orgID.
charityName	string	Name of the charitable organization.
tagLine	string	Tagline describing the charity.
websiteURL	anyURI	URL of the organization's website.
charityNavigatorURL	anyURI
mission	string	The organization's mission statement.
phoneNumber	string	Main phone number of the organization.
generalEmail	string	General email address for the organization.
category	Category	The primary category of the charity.
categoryID	string	Charity Navigator's unique identifier for the category.
categoryName	string	Name of the category.
image	anyURI	URL for an image representing the Category.
charityNavigatorURL	anyURI	URL to the Category page on Charity Navigator's website.
cause	Cause	The primary cause of this organization's charitable work as assigned by Charity Navigator.
causeID	string	Charity Navigator's unique identifier for the cause.
causeName	string	Name of the cause.
image	anyURI	URL for an image representing the Cause.
charityNavigatorURL	anyURI	URL to the Cause page on Charity Navigator's website.
irsClassification	IRSClassification	The classification and tax treatment of the Organization by the Internal Revenue Service.
subsection	string	A subsection in the tax code which defines the category under which an organization may be exempt from taxes.
foundationStatus	string	IRS classification of type of foundation. This is only applicable to 501(c)(3) Foundations.
deductibility	DeductibilityType	Specifies whether donations to this organization are tax-deductible.
deductibilityDetail	string	Provides more information when deductibility is NOT_DEDUCTIBLE_GENERALLY, indicating that donations to an organization are not generally deductible.
deductibilityCode	string	IRS Code to specify whether donations to this organization are tax-deductible.
nteeCode	string	The IRS's full classification code for the type of work this Organization performs
nteeClassification	string	The IRS's text description of the work that this Organization performs which corresponds to the full NTEECode
nteeLetter	string	Within the IRS's classification system, the first letter of the code represents broad subsectors, such as health, education, and youth development, of the charitable organization universe.
nteeType	string	The IRS's text description of the NTEE Letter portion of this this organizations classification
nteeSuffix	string	The last and optional character in the IRS classification system
affiliation	string	affiliation
groupName	string	groupName
exemptOrgStatus	string	exemptOrgStatus
exemptOrgStatusCode	string	exemptOrgStatusCode
rulingDate	string	rulingDate
assetAmount	string	assetAmount
incomeAmount	string	incomeAmount
latest990	string	latest990
filingRequirement	string	filingRequirement
accountingPeriod	string	accountingPeriod
classification	string	classification
mailingAddress	Address	Mailing address of the organization.
streetAddress1	string	First line of the street address.
streetAddress2	string	Second line of the street address.
city	string	City.
stateOrProvince	string	State or province.
postalCode	string	Postal code.
country	string	Country. Note that Charity Navigator currently covers only organizations based in the United States. If the Country is null, empty, or missing, it is safe to assume a US-based address.
donationAddress	Address	Address to send donations to the organization.
streetAddress1	string	First line of the street address.
streetAddress2	string	Second line of the street address.
city	string	City.
stateOrProvince	string	State or province.
postalCode	string	Postal code.
country	string	Country. Note that Charity Navigator currently covers only organizations based in the United States. If the Country is null, empty, or missing, it is safe to assume a US-based address.
activeAdvisories	AdvisoryCollection	Advisories related to the organization that are currently in effect.
removedAdvisories	AdvisoryCollection	Advisories that were previously in effect for the organization, and have been recently removed. NOTE: This may not be the complete history of past advisories. Charity Navigator includes only advisories within a specified aging policy.
currentBoardChair	Representative	Information about the current chairperson for the Board.
name	string	The name of the indivdual holding this position within the organization
title	string	The title of this individual at this organization
currentCEO	Representative	Information about the current CEO of the organization.
name	string	The name of the indivdual holding this position within the organization
title	string	The title of this individual at this organization
currentRating	RatingObject	Current rating for the organization.
ratingID	string	Unique identifier for this Rating.
score	decimal	Overall score, out of a possible 100, based on a two-dimensional analysis of financial health and accountability. Learn More
rating	int	Overall rating, on a four-star scale, based on a two-dimensional analysis of financial health and accountability. Learn More
ratingImage	IconSet	URLs to retrieve a star rating images for this Rating
publicationDate	date	Date the Rating was published
form990	Form990	Financial disclosures reported on the organization's IRS Form 990.
ratingHistory	RatingCollection	Ratings previously published on this organization. NOTE: This may not be the complete history of past ratings. Charity Navigator includes only ratings within a specified aging policy.

GET getOrganization

Retrieve full detail of a single Organization. This is a composite set of information describing an organization that may engage in charitable work. Normally the Organization data structure includes a single legal entity, though legal entity information may be excluded in exceptional cases.

Request

Parameters

Name	Documentation	Default	Property	Type
app_id	3Scale App ID: unique identifier for an application registered in the Charity Navigator developer portal.			string
app_key	3Scale App Key: a secret key to authenticate the assigned App ID.			string

Response OrganizationObject 200

Response ErrorInfo 400

Data Properties

Name	Type	Documentation
errorMessage	string

Invalid request. The ErrorInfo object should contain additional details.

Response ErrorInfo 404

Data Properties

Name	Type	Documentation
errorMessage	string

Not found. Indicates an invalid or non-existent path parameter value.

RatingCollection `Organizations/{ein}/Ratings` `Rating`

Represents the set of Organization Ratings in Charity Navigator.
Content
Subscription

Resource Properties

Media Types	application/json

Parameters

Name	Documentation	Default	Property	Type
ein				string

Data Properties

Rating	RatingObject*
ratingID	string
score	decimal
rating	int
ratingImage	IconSet
publicationDate	date
form990	Form990

GET getRatings

Retrieve all Charity Navigator ratings for a single organization.
Content
Subscription

Request

Parameters

Name	Documentation	Default	Type
app_id	3Scale App ID: unique identifier for an application registered in the Charity Navigator developer portal.		string
app_key	3Scale App Key: a secret key to authenticate the assigned App ID.		string
pageSize (optional)	Number of objects to return in a single response message. Used in combination with `pageNum` for paged responses. Default value is 100. If specified, must be an integer value between 1 and 1,000.	100	int
pageNum (optional)	Page number to return, in case the number of available objects in the result set is greater than the specified or default `pageSize`. Default value is 1. If the value of pageNum is greater than the number of pages in the result set, the method will return a 404 error. If the requested starting position, computed as `((pageNum-1) * pageSize) + 1`, is greater than the maximum supported result size of 10,000 objects, the method will return a 400 error.	1	integer

Response RatingCollection 200
Successful response, with a list of Ratings.

Response ErrorInfo 400

Data Properties

Name	Type	Documentation
errorMessage	string

Invalid request. The ErrorInfo object should contain additional details.

Response ErrorInfo 404

Data Properties

Name	Type	Documentation
errorMessage	string

Not found. This means there is no data that satisfies the request criteria, Or the specified pageNum is greater than the number of pages of data returned from the request query.

RatingObject `Organizations/{ein}/Ratings/{RatingID}` `Rating`

Represents a single Rating in Charity Navigator. Each rating is listed once, under its primary referenceOrganization. Note that the rating may apply to other organizations, and this is represented by includedOrganizations, which is a collection of hyperlinks to all of the organizations to which the rating applies.
Content
Subscription

Resource Properties

Media Types	application/json
Link Descriptors	ratingLink (`ratingID`, `score`, `rating`, `ratingImage`, `publicationDate`, `form990`) Default

Parameters

Name	Documentation	Default	Property	Type
ein				string
RatingID			ratingID	string

Data Properties

Name	Type	Documentation
ratingID	string	Unique identifier for this Rating.
score	decimal	Overall score, out of a possible 100, based on a two-dimensional analysis of financial health and accountability. Learn More
rating	int	Overall rating, on a four-star scale, based on a two-dimensional analysis of financial health and accountability. Learn More
publicationDate	date	Date the Rating was published
referenceOrganization	OrganizationObject	An organization to which the rating applies, and which may be used as reference to obtain descriptive organizational details.
ein	string!	The federal Employer Identification Number for the charitable organization. May be set to a system-assigned value in cases where the organization is fictitious, or the real EIN is not available.
charityName	string	Name of the charitable organization.
includedOrganizations	OrganizationObject+	All organizations to which the rating applies. In most cases, a rating will apply to a single organization, and in that case primaryOrganization will be the only member of the includedOrganizationsList. A rating for a composite organization will include multiple individual organizations, each with a distinct EIN.
ein	string!	The federal Employer Identification Number for the charitable organization. May be set to a system-assigned value in cases where the organization is fictitious, or the real EIN is not available.
charityName	string	Name of the charitable organization.
ratingImage	IconSet	URLs to retrieve a star rating images for this Rating
small	anyURI
large	anyURI
form990	Form990	Financial disclosures reported on the organization's IRS Form 990.
fundraisingExpenses	decimal	Fundraising expenses as reported on the income statement for the rating period. This measure reflects what a charity spends to raise money. Fundraising expenses can include campaign printing, publicity, mailing, and staffing and costs incurred in soliciting donations, memberships, and grants. Learn More
administrativeExpenses	decimal	Administrative expenses as reported on the income statement for the rating period. This measure reflects what percent of its total budget a charity spends on overhead, administrative staff and associated costs, and organizational meetings. Learn More
programExpenses	decimal	Program expenses as reported on the income statement for the rating period. This measure reflects what a charity spends to raise money. Fundraising expenses can include campaign printing, publicity, mailing, and staffing and costs incurred in soliciting donations, memberships, and grants. Learn More
totalExpenses	decimal	Total functional expenses, computed as the sum of program expenses, administrative expenses and fundraising expenses, as reported on the income statement for the rating period.
totalRevenue	decimal	Total revenue, as reported on the income statement for the rating period. Charities can derive revenue or funding from a variety of sources, including contributions, program services, membership dues, interest on savings, investment income, special events, and sales of inventory.
totalNetAssets	decimal	Total net assets, computed as he difference between assets and liabilities, as reported on the organization's financial statement for the rating period. Although charities do not exist to make money, they do work to build and maintain reasonable reserves of net assets. Growing its net assets helps a charity outpace inflation and sustain future program activities. Learn More
totalContributions	decimal	Total contributions is the sum of all contributions - including gifts, and grants, federated campaigns, membership dues, fundraising events, related organizations, and government grants.
primaryRevenue	decimal	The revenue a charity generates as a result of the work it does. A charity's primary revenue includes grants and contributions, revenue produced from programs and services, and membership fees and dues. Learn More
otherRevenue	decimal	In addition to primary revenue sources, charities derive revenue from investments, rents, special events, sales of inventory, and other unrelated business income. Learn More
ceoCompensationPercent	decimal	Based on the data found in each charity's most recently filed Form 990, we include salary, cash bonuses, and expense accounts when we measure a CEO's compensation. We do not include contributions to benefit plans or deferred compensation that is allocated to be paid in later years. Deferred compensation is often accrued over many years and then is paid as a lump sum in one year. As such, we do include deferred compensation as part of the compensation figure in the year in which it is actually paid out to the employee and/or when it is expensed per the 990. Many charities use fiscal years that differ from the calendar year. In these cases, it is important to recognize that the CEO’s compensation reported on the Form 990 reflects the CEO’s pay for the calendar year, not the fiscal year. Why? Because the IRS requires that charities report compensation on the Form 990 exactly the same as they did on the W-2 Form (which is based on the calendar year). Many donors are understandably interested in how much the leaders of charities earn. This information is public record so Charity Navigator reports it for our users. This information does not factor into an organization's Charity Navigator rating. We provide this percentage so donors can quickly put the salary into perspective. For comparative purposes, a charity with total expenses of $20 million, which compensates its highest paid executive at $200,000 per year (or 1%) would appear to have tighter control on expenses than the $1 million organization which pays its chief executive the same amount (or 20% of expenses for one person). Learn More
financialRating	FinancialRating	Financial Score, Rating, and performance metrics.
score	decimal	Overall financial score, out of a possible 100, based on a set of individual measures of financial health. Learn More
rating	int	Overall financial rating, on a four-star scale. Learn More
performanceMetrics	PerformanceMetrics	Financial performance metrics for the organization.
fundraisingEfficiency	decimal	The amount spent to raise $1 in charitable contributions. Learn More
fundraisingExpensesRatio	decimal	This measure reflects what a charity spends to raise money. Learn More
programExpensesGrowth	decimal	Average annual growth of organization's program expenses. Learn More
programExpensesRatio	decimal	The percent of its total expenses a charity spends on the programs and services it exists to deliver. Learn More
administrationExpensesRatio	decimal	This measure reflects what percent of its total budget a charity spends on overhead, administrative staff and associated costs, and organizational meetings. Learn More
liabilitiesToAssetsRatio	decimal	Liabilities to Assets is an indicator of an organization’s solvency and or long term sustainability. This ratio is computed by dividing a charity's total liabilities by its total assets. Learn More
workingCapitalRatio	decimal	Determines how long a charity could sustain its level of spending using its net available assets, or working capital, as reported on its most recently filed Form 990. Learn More
primaryRevenueGrowth	decimal	Prior to CN2.1 Ratings looked at Primary Revenue Growth for an Organization in addition to Program Expense Growth. For CN2.1 Ratings this is no longer considered and will be null
accountabilityRating	AccountabilityRating	Accountability and Transparency Score, Rating, and test indicators.
score	decimal	Overall accountability score, out of a possible 100, based on a set of individual measures of accountability and transparency. Learn More
rating	int	Overall accountability and transparency rating, on a four-star scale. Learn More
accountabilityTests	AccountabilityTests	Pass/fail criteria used to determine the accountability score and rating.
boardListStatus	PassFailOrNotReported	"Pass" indicates that the board members are listed on the Organization's website. Other possible values are "Fail" or "Not Reported". Learn More
staffListStatus	PassFailOrNotReported	"Pass" indicates that the organization's key staff members are named on its website. Other possible values are "Fail" or "Not Reported". Learn More
auditedFinancialStatus	PassFailOrNotReported	"Pass" indicates that audited financial statements are available on the organization's website. Other possible values are "Fail" or "Not Reported". Learn More
form990Status	PassFailOrNotReported	"Pass" indicates that a current IRS Form 990 is available on the organization's website. Other possible values are "Fail" or "Not Reported". Learn More
privacyStatus	PassFailOrOptOut	"Pass" indicates that the organization has a written donor privacy policy published on its website, with strong and unequivocal privacy protections for donors. Other possible values are "Fail" or "Opt Out". Learn More
loansToOrFromOfficers	PassFailOrNotReported	"Pass" indicates that the organization has not reported any loans to or from officers or other interested parties. Other possible values are "Fail" or "Not Reported". Learn More
loansToOfficers	PassFailOrNotReported	"Pass" indicates that the charity did not report reciving any loans from their Officers on their Form 990. Other possible values are "Fail" or "Not Reported". Learn More
loansFromOfficers	PassFailOrNotReported	"Pass" indicates that the charity did not report making any loans to their Officers on their Form 990. Other possible values are "Fail" or "Not Reported". Learn More
materialDiversionOfAssets	PassFailOrRemediated	"Pass" indicates that there has been no diversion of assets within the last two years. Other possible values are "Fail" or "Remediated". Learn More
boardMeetingMinutes	PassFailOrNotReported	"Pass" indicates that the organization keeps meeting minutes, and reports availability of these on IRS Form 990. Other possible values are "Fail" or "Not Reported". Learn More
distributes990ToBoard	PassFailOrNotReported	"Pass" indicates that the organization has provided copies of its Form 990 the governing body in advance of filing. Other possible values are "Fail" or "Not Reported". Learn More
conflictOfInterestPolicy	PassFailOrNotReported	"Pass" indicates that the organization has a conflict of interest policy in place. Other possible values are "Fail" or "Not Reported". Learn More
whistleBlowerPolicy	PassFailOrNotReported	"Pass" indicates that the organization has a whistleblower policy, as reported on IRS Form 990. Other possible values are "Fail" or "Not Reported". Learn More
recordsRetentionPolicy	PassFailOrNotReported	"Pass" indicates that the organization has a records retention and destruction policy, as reported on IRS Form 990. Other possible values are "Fail" or "Not Reported". Learn More
reportsCEOAndSalary	PassFailOrNotReported	"Pass" indicates that the organization included the CEO's name and compensation on Form 990. Other possible values are "Fail" or "Not Reported". Learn More
ceoCompensationProcedure	PassFailOrNotReported	"Pass" indicates that the organization has a consistent policy for determining CEO compensation, meeting certain best practices and standards established by Charity Navigator. Other possible values are "Fail" or "Not Reported". Learn More
compensatesBoard	PassFailOrNotReported	"Pass" indicates that the organization lists its board members, and does not compensate them for serving on its Board of Directors. Other possible values are "Fail" or "Not Reported". Learn More
independentAudit	PassFailOrPartial	"Pass" indicates that the organization's financial statements are prepared by an independent accountant with oversight from an audit committee. Other possible values are "Fail," "Partial," or "Not Reported". Learn More
independentBoard	PassFailOrNotReported	"Pass" indicates that independent Board members are a voting majority and also at least five in number. Other possible values are "Fail" or "Not Reported". Learn More

GET getRating

Retrieve a single Rating object for an Organization. Each rating is listed once, under its primary referenceOrganization. Note that the rating may apply to other organizations, and this is represented by includedOrganizations, which is a collection of hyperlinks to all of the organizations to which the rating applies. The rating is a point-in-time assessment provided by Charity Navigator, along with related metrics and ratios taken from financial statements for a fiscal year, on which the rating is based.
Content
Subscription

Request

Parameters

Name	Documentation	Default	Property	Type
app_id	3Scale App ID: unique identifier for an application registered in the Charity Navigator developer portal.			string
app_key	3Scale App Key: a secret key to authenticate the assigned App ID.			string

Response RatingObject 200

Response ErrorInfo 400

Data Properties

Name	Type	Documentation
errorMessage	string

Invalid request. The ErrorInfo object should contain additional details.

Response ErrorInfo 404

Data Properties

Name	Type	Documentation
errorMessage	string

Not found. Indicates an invalid or non-existent path parameter value.

AdvisoryCollection `Organizations/{ein}/Advisories` `Advisory`

Represents the complete set of available Advisories.

Resource Properties

Media Types	application/json

Parameters

Name	Documentation	Default	Property	Type
ein				string

Data Properties

Name	Type	Documentation
advisoryID	string	Unique identifier for this advisory.
severity	Severity	Severity of the Advisory.
datePublished	date	Date when the Advisory was first published.
dateRemoved	date	Date when the Advisory was removed. Advisory can be assumed to be active if dateRemoved is omitted.
dateModified	date	Date when the Advisory most recently modified.
organization	OrganizationObject	The Organization that is the subject of the advisory.
ein	string!	The federal Employer Identification Number for the charitable organization. May be set to a system-assigned value in cases where the organization is fictitious, or the real EIN is not available.
charityName	string	Name of the charitable organization.
sources	AdvisorySource+	Ordered list of Advisory Sources
datePublished	date	Date when the Advisory Source was published.
dateRemoved	date	Date when the Advisory Source was removed. The Advisory Source can be assumed to ba active if dateRemoved is omitted.
dateModified	date	Date when the Advisory Source was most recently modified.
publisher	string	Name of the Advisory Source publisher.
url	anyURI	URL referring to the Advisory Source.
summary	string	A summary description of the Advisory Source.

GET getAdvisories

Retrieve the full set of Charity Navigator advisories for a specified organization. An advisory is a cautionary communication from Charity Navigator, advising of unusual events or behavior related to a known organization.

Request

Parameters

Name Documentation Default Property Type

app_id

3Scale App ID: unique identifier for an application registered in the Charity Navigator developer portal.

string

app_key

3Scale App Key: a secret key to authenticate the assigned App ID.

string

pageSize (optional)

Number of objects to return in a single response message. Used in combination with pageNum for paged responses. Default value is 100. If specified, must be an integer value between 1 and 1,000.

100

int

pageNum (optional)

integer

status (optional)

An optional filter parameter to limit the Advisories returned, based on status:

Status Value	Advisories Included
ALL	All advisories included, regardless of status.
ACTIVE	Includes only advisories that are currently active.
REMOVED	Includes only advisories that have been removed.

Omitting the status property is the equivalent of specifying ALL. Any value other than the ones listed above will result in an HTTP error 400.

ALL

string

Response AdvisoryCollection 200
Successful response, with a list of Advisorites.

Response ErrorInfo 400

Data Properties

Name	Type	Documentation
errorMessage	string

Invalid request. The ErrorInfo object should contain additional details.

Response ErrorInfo 404

Data Properties

Name	Type	Documentation
errorMessage	string

Not found. This means there is no data that satisfies the request criteria, Or the specified pageNum is greater than the number of pages of data returned from the request query.

AdvisoryObject `Organizations/{ein}/Advisories/{AdvisoryID}` `Advisory`

Represents a single Advisory.

Resource Properties

Media Types	application/json
Link Descriptors	AdvisoryLink (`advisoryID`, `dateModified`, `dateRemoved`, `severity`) Default

Parameters

Name	Documentation	Default	Property	Type
ein				string
AdvisoryID			advisoryID	string

Data Properties

Name	Type	Documentation
advisoryID	string	Unique identifier for this advisory.
severity	Severity	Severity of the Advisory.
datePublished	date	Date when the Advisory was first published.
dateRemoved	date	Date when the Advisory was removed. Advisory can be assumed to be active if dateRemoved is omitted.
dateModified	date	Date when the Advisory most recently modified.
organization	OrganizationObject	The Organization that is the subject of the advisory.
ein	string!	The federal Employer Identification Number for the charitable organization. May be set to a system-assigned value in cases where the organization is fictitious, or the real EIN is not available.
charityName	string	Name of the charitable organization.
sources	AdvisorySource+	Ordered list of Advisory Sources
datePublished	date	Date when the Advisory Source was published.
dateRemoved	date	Date when the Advisory Source was removed. The Advisory Source can be assumed to ba active if dateRemoved is omitted.
dateModified	date	Date when the Advisory Source was most recently modified.
publisher	string	Name of the Advisory Source publisher.
url	anyURI	URL referring to the Advisory Source.
summary	string	A summary description of the Advisory Source.

GET getAdvisory

Retrieve full details of a single Advisory, under a given organization. An advisory is a cautionary communication from Charity Navigator, advising of unusual events or behavior related to a known organization.

Request

Empty Request body, standard for a GET method.

Parameters

Name	Documentation	Default	Property	Type
app_id	3Scale App ID: unique identifier for an application registered in the Charity Navigator developer portal.			string
app_key	3Scale App Key: a secret key to authenticate the assigned App ID.			string

Response AdvisoryObject 200
Successful response, with the requested object instance.

Response ErrorInfo 400

Data Properties

Name	Type	Documentation
errorMessage	string

Invalid request. The ErrorInfo object should contain additional details.

Response ErrorInfo 404

Data Properties

Name	Type	Documentation
errorMessage	string

Not found. Indicates an invalid or non-existent path parameter value.

ListCollection `Lists` `List`

Represents the full set of Lists defined in Charity Navigator.
Content
Subscription

Resource Properties

Media Types	application/json

Data Properties

List	ListObject*
listID	string
listType	string
listName	string
listAbstract	string
listImageURL	anyURI
isCurrentlyFeatured	boolean
sortOrder	integer

GET getLists

Retrieve a set of Lists defined in Charity Navigator. Each entry in this collection is a curated or generated list of organizations, published by Charity Navigator.
Content
Subscription

Request

Parameters

Name	Documentation	Default	Type
app_id	3Scale App ID: unique identifier for an application registered in the Charity Navigator developer portal.		string
app_key	3Scale App Key: a secret key to authenticate the assigned App ID.		string
pageSize (optional)	Number of objects to return in a single response message. Used in combination with `pageNum` for paged responses. Default value is 100. If specified, must be an integer value between 1 and 1,000.	100	int
pageNum (optional)	Page number to return, in case the number of available objects in the result set is greater than the specified or default `pageSize`. Default value is 1. If the value of pageNum is greater than the number of pages in the result set, the method will return a 404 error. If the requested starting position, computed as `((pageNum-1) * pageSize) + 1`, is greater than the maximum supported result size of 10,000 objects, the method will return a 400 error.	1	integer

Response ListCollection 200
Successful response, with a list of Advisorites.

Response ErrorInfo 400

Data Properties

Name	Type	Documentation
errorMessage	string

Invalid request. The ErrorInfo object should contain additional details.

Response ErrorInfo 404

Data Properties

Name	Type	Documentation
errorMessage	string

Not found. This means there is no data that satisfies the request criteria, Or the specified pageNum is greater than the number of pages of data returned from the request query.

ListObject `Lists/{ListID}` `List`

Represents a single List defined in Charity Navigator.
Content
Subscription

Resource Properties

Media Types	application/json
Link Descriptors	ListObjectLink (`listID`, `listType`, `listName`, `listAbstract`, `listImageURL`, `isCurrentlyFeatured`, `sortOrder`) Default

Parameters

Name	Documentation	Default	Property	Type
ListID			listID	string

Data Properties

Name	Type	Documentation
listID	string	Unique ID for the list, assigned by Charity Navigator.
listName	string	Name of the list.
listType	string	A general classification of the list.
isCurrentlyFeatured	boolean	Boolean field, true is list is currently featured on site.
sortOrder	integer	If list is currently featured, the sort order it is currently displayed in.
listAbstract	string	Short list description.
listExplanation	string	Long list description.
listImageURL	anyURI	URL for an image representing the List.
charityNavigatorURL	anyURI	URL to the List page on Charity Navigator's website.
groups	OrganizationGroup*	Groups of organizations within the list. May be a single, unnamed group in the case of a flat list.
groupName	string	Optional name of the group.
groupDescription	string	Description of the group.
organizations	OrgListEntry*	Organization entries in the list.
rank	int	Rank of the organization within its containing group.
groupDescription	string	Description of the group.
groupName	string	Optional name of the group.
organization	OrganizationObject	Organization participating in the list.
ein	string!	The federal Employer Identification Number for the charitable organization. May be set to a system-assigned value in cases where the organization is fictitious, or the real EIN is not available.
charityName	string	Name of the charitable organization.

GET getList

Retrieve a curated or generated list of organizations, published by Charity Navigator.
Content
Subscription

Request

Empty Request body, standard for a GET method.

Parameters

Name	Documentation	Default	Property	Type
app_id	3Scale App ID: unique identifier for an application registered in the Charity Navigator developer portal.			string
app_key	3Scale App Key: a secret key to authenticate the assigned App ID.			string

Response ListObject 200
Successful response, with the requested object instance.

Response ErrorInfo 400

Data Properties

Name	Type	Documentation
errorMessage	string

Invalid request. The ErrorInfo object should contain additional details.

Response ErrorInfo 404

Data Properties

Name	Type	Documentation
errorMessage	string

Not found. Indicates an invalid or non-existent path parameter value.

CategoryCollection `Categories` `Category`

Charity Navigator's classification hierarchy for charitable Organizations, including Categories and Causes.
Content
Subscription

Resource Properties

Media Types	application/json

Data Properties

Name	Type	Documentation
categoryID	string	Charity Navigator's unique identifier for the category.
categoryName	string	Name of the category.
image	anyURI	URL for an image representing the Category.
charityNavigatorURL	anyURI	URL to the Category page on Charity Navigator's website.
causes	Cause*	A list of specific causes, contained within this general category.
causeID	string	Charity Navigator's unique identifier for the cause.
causeName	string	Name of the cause.
image	anyURI	URL for an image representing the Cause.
charityNavigatorURL	anyURI	URL to the Cause page on Charity Navigator's website.

GET getCategories

Returns metadata for Charity Navigator's classification hierarchy for charitable Organizations. Category is the top-level classifier, and each category may contain a number of Causes.
Content
Subscription

Request

Parameters

Name	Documentation	Default	Property	Type
app_id	3Scale App ID: unique identifier for an application registered in the Charity Navigator developer portal.			string
app_key	3Scale App Key: a secret key to authenticate the assigned App ID.			string

Response CategoryCollection 200

ActiveAdvisoryCollection `Advisory` `AdvisorySummary`

Represents the complete list of Organizations with active advisories.

Resource Properties

Media Types	application/json

Data Properties

Name	Type	Documentation
mailingAddress	Address	Mailing address of the organization.
city	string	City.
stateOrProvince	string	State or province.
organization	Organization	Link to the organization resource, with all available details.
ein	string!	The federal Employer Identification Number for the charitable organization. May be set to a system-assigned value in cases where the organization is fictitious, or the real EIN is not available.
charityName	string	Name of the charitable organization.
charityNavigatorURL	anyURI
advisories	AdvisoryRollup	Advisories related to the organization that are currently in effect.
severity	Severity	Rolled up severity level of all active advisory records for the organization. A NULL value means there are no active advisory records
active	AdvisoryCollection	Reference to all active advisory records for an organization.

GET getAllActiveAdvisories

Request

Parameters

Name	Documentation	Default	Type
app_id	3Scale App ID: unique identifier for an application registered in the Charity Navigator developer portal.		string
app_key	3Scale App Key: a secret key to authenticate the assigned App ID.		string
pageSize (optional)	Number of organizations to return in a single response message. Used in combination with `pageNum` for paged responses. Default value is 100. If specified, must be an integer value between 1 and 1,000.	100	int
pageNum (optional)	Page number to return, in case the number of available objects in the result set is greater than the specified or default `pageSize`. Default value is 1. If the value of pageNum is greater than the number of pages in the result set, the method will return a 404 error. If the requested starting position, computed as `((pageNum-1) * pageSize) + 1`, is greater than the maximum supported result size of 10,000 objects, the method will return a 400 error.	1	integer

Response ActiveAdvisoryCollection 200
Successful response, with a list of Advisorites.

Response ErrorInfo 400

Data Properties

Name	Type	Documentation
errorMessage	string

Invalid request. The ErrorInfo object should contain additional details.

Response ErrorInfo 404

Data Properties

Name	Type	Documentation
errorMessage	string

Not found. This means there is no data that satisfies the request criteria, Or the specified pageNum is greater than the number of pages of data returned from the request query.

CharityNavigatorDataModel

The core data model for Charity Navigator APIs. This defines the essential concepts, any of which may be used in any number of APIs. Each API usage context can specify a realization of the data structure, which can specify a subset of relevant properties, contextual constraints, and reference treatments as hyperlinks and/or embedded data.

`Organization`

A composite set of information describing an organization that may engage in charitable work. Normally the Organization data structure includes a single legal entity, though legal entity information may be excluded in exceptional cases.

Properties

Name	Type	Documentation
ein	string !	The federal Employer Identification Number for the charitable organization. May be set to a system-assigned value in cases where the organization is fictitious, or the real EIN is not available.
orgID	integer	Internal identifier assigned by Charity Navigator. Only rated charities have an orgID.
charityName	string	Name of the charitable organization.
tagLine	string	Tagline describing the charity.
irsClassification	IRSClassification	The classification and tax treatment of the Organization by the Internal Revenue Service.
websiteURL	anyURI	URL of the organization's website.
charityNavigatorURL	anyURI
category	Category	The primary category of the charity.
cause	Cause	The primary cause of this organization's charitable work as assigned by Charity Navigator.
mission	string	The organization's mission statement.
mailingAddress	containing Address	Mailing address of the organization.
donationAddress	containing Address	Address to send donations to the organization.
phoneNumber	string	Main phone number of the organization.
generalEmail	string	General email address for the organization.
activeAdvisories	Advisory *	Advisories related to the organization that are currently in effect.
removedAdvisories	Advisory *	Advisories that were previously in effect for the organization, and have been recently removed. NOTE: This may not be the complete history of past advisories. Charity Navigator includes only advisories within a specified aging policy.
currentBoardChair	Representative	Information about the current chairperson for the Board.
currentCEO	Representative	Information about the current CEO of the organization.
currentRating	Rating	Current rating for the organization.
ratingHistory	Rating *	Ratings previously published on this organization. NOTE: This may not be the complete history of past ratings. Charity Navigator includes only ratings within a specified aging policy.

`AdvisorySummary`

Essential information about an Organization advisory, used in resources or methods that do not need the full detail of the organization's advisory'. Includes references to the Organization and AdvisoryRollup, which may be realized as a hyperlink.

Properties

Name	Type	Documentation
organization	Organization !	Link to the organization resource, with all available details.
ein	string !	The federal Employer Identification Number for the charitable organization. May be set to a system-assigned value in cases where the organization is fictitious, or the real EIN is not available.
charityName	string	Name of the charitable organization.
mailingAddress	containing Address	Mailing address of the organization.
charityNavigatorURL	anyURI
advisories	AdvisoryRollup	Advisories related to the organization that are currently in effect.

`OrganizationSummary`

Essential information about an Organization, used in resources or methods that do not need the full detail of the organization. Includes a reference to the Organization, which may be realized as a hyperlink.

Properties

Name	Type	Documentation
organization	Organization !	Link to the organization resource, with all available details.
ein	string !	The federal Employer Identification Number for the charitable organization. May be set to a system-assigned value in cases where the organization is fictitious, or the real EIN is not available.
orgID	integer	Internal identifier assigned by Charity Navigator. Only rated charities have an orgID.
charityName	string	Name of the charitable organization.
tagLine	string	Tagline describing the charity.
mailingAddress	containing Address	Mailing address of the organization.
donationAddress	containing Address	Address to send donations to the organization.
category	Category	The primary category of this organization's charitable work as assigned by Charity Navigator.
cause	Cause	The primary cause of this organization's charitable work as assigned by Charity Navigator.
currentRating	Rating	Current rating for the organization.
irsClassification	IRSClassification	The classification and tax treatment of the Organization by the Internal Revenue Service.
websiteURL	anyURI	URL of the organization's website.
charityNavigatorURL	anyURI
mission	string	The organization's mission statement.
advisories	AdvisoryRollup	Advisories related to the organization that are currently in effect.

`Address`

A physical or postal address.

Properties

Name	Type	Documentation
streetAddress1	string	First line of the street address.
streetAddress2	string	Second line of the street address.
city	string	City.
stateOrProvince	string	State or province.
postalCode	string	Postal code.
country	string	Country. Note that Charity Navigator currently covers only organizations based in the United States. If the Country is null, empty, or missing, it is safe to assume a US-based address.

`Representative`

An officer or other individual in a specified role within an Organization.

Properties

Name	Type	Documentation
name	string	The name of the indivdual holding this position within the organization
title	string	The title of this individual at this organization

`IRSClassification`

Describes the classification and tax treatment of the Organization by the Internal Revenue Service.

Properties

Name	Type	Documentation
subsection	string	A subsection in the tax code which defines the category under which an organization may be exempt from taxes.
foundationStatus	string	IRS classification of type of foundation. This is only applicable to 501(c)(3) Foundations.
deductibility	DeductibilityType	Specifies whether donations to this organization are tax-deductible.
deductibilityDetail	string	Provides more information when deductibility is NOT_DEDUCTIBLE_GENERALLY, indicating that donations to an organization are not generally deductible.
deductibilityCode	string	IRS Code to specify whether donations to this organization are tax-deductible.
nteeCode	string	The IRS's full classification code for the type of work this Organization performs
nteeClassification	string	The IRS's text description of the work that this Organization performs which corresponds to the full NTEECode
nteeLetter	string	Within the IRS's classification system, the first letter of the code represents broad subsectors, such as health, education, and youth development, of the charitable organization universe.
nteeType	string	The IRS's text description of the NTEE Letter portion of this this organizations classification
nteeSuffix	string	The last and optional character in the IRS classification system
affiliation	string	affiliation
groupName	string	groupName
exemptOrgStatus	string	exemptOrgStatus
exemptOrgStatusCode	string	exemptOrgStatusCode
rulingDate	string	rulingDate
assetAmount	string	assetAmount
incomeAmount	string	incomeAmount
latest990	string	latest990
filingRequirement	string	filingRequirement
accountingPeriod	string	accountingPeriod
classification	string	classification

string Enumeration`DeductibilityType`

A value that summarizes deductibilty of donations to an Organization under a given IRS Classification.

Enumeration Constants

Name	Value	Documentation
DEDUCTIBLE	Deductible
NOT_DEDUCTIBLE	Not Deductible
NOT_DEDUCTIBLE_GENERALLY	Not Deductible, Generally

`Rating`

A point-in-time rating provided by Charity Navigator, along with related metrics and ratios taken from financial statements for a fiscal year, on which the rating is based.

Properties

Name	Type	Documentation
ratingID	string	Unique identifier for this Rating.
includedOrganizations	Organization +	All organizations to which the rating applies. In most cases, a rating will apply to a single organization, and in that case primaryOrganization will be the only member of the includedOrganizationsList. A rating for a composite organization will include multiple individual organizations, each with a distinct EIN.
referenceOrganization	Organization	An organization to which the rating applies, and which may be used as reference to obtain descriptive organizational details.
score	decimal	Overall score, out of a possible 100, based on a two-dimensional analysis of financial health and accountability. Learn More
rating	int	Overall rating, on a four-star scale, based on a two-dimensional analysis of financial health and accountability. Learn More
ratingImage	IconSet	URLs to retrieve a star rating images for this Rating
form990	Form990	Financial disclosures reported on the organization's IRS Form 990.
financialRating	FinancialRating	Financial Score, Rating, and performance metrics.
accountabilityRating	AccountabilityRating	Accountability and Transparency Score, Rating, and test indicators.
publicationDate	date	Date the Rating was published

`IconSet`

A set of URLs different sized icons with the same underlying meaning.

Properties

Name	Type	Documentation
small	anyURI
large	anyURI

`PerformanceMetrics`

A collection of financial performance metrics, each of which has an assigned weight in Charity Navigator's Financial Score and Financial Rating

Properties

Name	Type	Documentation
fundraisingEfficiency	decimal	The amount spent to raise $1 in charitable contributions. Learn More
fundraisingExpensesRatio	decimal	This measure reflects what a charity spends to raise money. Learn More
programExpensesGrowth	decimal	Average annual growth of organization's program expenses. Learn More
programExpensesRatio	decimal	The percent of its total expenses a charity spends on the programs and services it exists to deliver. Learn More
administrationExpensesRatio	decimal	This measure reflects what percent of its total budget a charity spends on overhead, administrative staff and associated costs, and organizational meetings. Learn More
liabilitiesToAssetsRatio	decimal	Liabilities to Assets is an indicator of an organization’s solvency and or long term sustainability. This ratio is computed by dividing a charity's total liabilities by its total assets. Learn More
workingCapitalRatio	decimal	Determines how long a charity could sustain its level of spending using its net available assets, or working capital, as reported on its most recently filed Form 990. Learn More
primaryRevenueGrowth	decimal	Prior to CN2.1 Ratings looked at Primary Revenue Growth for an Organization in addition to Program Expense Growth. For CN2.1 Ratings this is no longer considered and will be null

`FinancialRating`

A composite of an organization's Financial Score and Financial Rating, along with the performance metrics that Charity Navigator compiles to determine the score.

Properties

Name	Type	Documentation
score	decimal	Overall financial score, out of a possible 100, based on a set of individual measures of financial health. Learn More
rating	int	Overall financial rating, on a four-star scale. Learn More
performanceMetrics	PerformanceMetrics	Financial performance metrics for the organization.

`AccountabilityRating`

A composite of an organization's Accountability and Transparency Score and Rating, along with the accountability and transparency tests that Charity Navigator compiles to determine the score.

Properties

Name	Type	Documentation
score	decimal	Overall accountability score, out of a possible 100, based on a set of individual measures of accountability and transparency. Learn More
rating	int	Overall accountability and transparency rating, on a four-star scale. Learn More
accountabilityTests	AccountabilityTests	Pass/fail criteria used to determine the accountability score and rating.

`Form990`

A subset of financial disclosures reported on the organization's IRS Form 990.

Properties

Name	Type	Documentation
fundraisingExpenses	decimal	Fundraising expenses as reported on the income statement for the rating period. This measure reflects what a charity spends to raise money. Fundraising expenses can include campaign printing, publicity, mailing, and staffing and costs incurred in soliciting donations, memberships, and grants. Learn More
administrativeExpenses	decimal	Administrative expenses as reported on the income statement for the rating period. This measure reflects what percent of its total budget a charity spends on overhead, administrative staff and associated costs, and organizational meetings. Learn More
programExpenses	decimal	Program expenses as reported on the income statement for the rating period. This measure reflects what a charity spends to raise money. Fundraising expenses can include campaign printing, publicity, mailing, and staffing and costs incurred in soliciting donations, memberships, and grants. Learn More
totalExpenses	decimal	Total functional expenses, computed as the sum of program expenses, administrative expenses and fundraising expenses, as reported on the income statement for the rating period.
totalRevenue	decimal	Total revenue, as reported on the income statement for the rating period. Charities can derive revenue or funding from a variety of sources, including contributions, program services, membership dues, interest on savings, investment income, special events, and sales of inventory.
totalNetAssets	decimal	Total net assets, computed as he difference between assets and liabilities, as reported on the organization's financial statement for the rating period. Although charities do not exist to make money, they do work to build and maintain reasonable reserves of net assets. Growing its net assets helps a charity outpace inflation and sustain future program activities. Learn More
totalContributions	decimal	Total contributions is the sum of all contributions - including gifts, and grants, federated campaigns, membership dues, fundraising events, related organizations, and government grants.
primaryRevenue	decimal	The revenue a charity generates as a result of the work it does. A charity's primary revenue includes grants and contributions, revenue produced from programs and services, and membership fees and dues. Learn More
otherRevenue	decimal	In addition to primary revenue sources, charities derive revenue from investments, rents, special events, sales of inventory, and other unrelated business income. Learn More
ceoCompensationPercent	decimal	Based on the data found in each charity's most recently filed Form 990, we include salary, cash bonuses, and expense accounts when we measure a CEO's compensation. We do not include contributions to benefit plans or deferred compensation that is allocated to be paid in later years. Deferred compensation is often accrued over many years and then is paid as a lump sum in one year. As such, we do include deferred compensation as part of the compensation figure in the year in which it is actually paid out to the employee and/or when it is expensed per the 990. Many charities use fiscal years that differ from the calendar year. In these cases, it is important to recognize that the CEO’s compensation reported on the Form 990 reflects the CEO’s pay for the calendar year, not the fiscal year. Why? Because the IRS requires that charities report compensation on the Form 990 exactly the same as they did on the W-2 Form (which is based on the calendar year). Many donors are understandably interested in how much the leaders of charities earn. This information is public record so Charity Navigator reports it for our users. This information does not factor into an organization's Charity Navigator rating. We provide this percentage so donors can quickly put the salary into perspective. For comparative purposes, a charity with total expenses of $20 million, which compensates its highest paid executive at $200,000 per year (or 1%) would appear to have tighter control on expenses than the $1 million organization which pays its chief executive the same amount (or 20% of expenses for one person). Learn More

`AccountabilityTests`

A set of conditional tests, each of which has an assigned weight in Charity Navigator's Accountability and Transparency Score and Rating. These tests generally have a value of "Pass" or "Fail." Some tests may be "Not Reported", or have a specific "Partial" state, somewhere in between an unequivocal pass or fail state.

Properties

Name	Type	Documentation
boardListStatus	PassFailOrNotReported	"Pass" indicates that the board members are listed on the Organization's website. Other possible values are "Fail" or "Not Reported". Learn More
staffListStatus	PassFailOrNotReported	"Pass" indicates that the organization's key staff members are named on its website. Other possible values are "Fail" or "Not Reported". Learn More
auditedFinancialStatus	PassFailOrNotReported	"Pass" indicates that audited financial statements are available on the organization's website. Other possible values are "Fail" or "Not Reported". Learn More
form990Status	PassFailOrNotReported	"Pass" indicates that a current IRS Form 990 is available on the organization's website. Other possible values are "Fail" or "Not Reported". Learn More
privacyStatus	PassFailOrOptOut	"Pass" indicates that the organization has a written donor privacy policy published on its website, with strong and unequivocal privacy protections for donors. Other possible values are "Fail" or "Opt Out". Learn More
loansToOrFromOfficers	PassFailOrNotReported	"Pass" indicates that the organization has not reported any loans to or from officers or other interested parties. Other possible values are "Fail" or "Not Reported". Learn More
loansToOfficers	PassFailOrNotReported	"Pass" indicates that the charity did not report reciving any loans from their Officers on their Form 990. Other possible values are "Fail" or "Not Reported". Learn More
loansFromOfficers	PassFailOrNotReported	"Pass" indicates that the charity did not report making any loans to their Officers on their Form 990. Other possible values are "Fail" or "Not Reported". Learn More
materialDiversionOfAssets	PassFailOrRemediated	"Pass" indicates that there has been no diversion of assets within the last two years. Other possible values are "Fail" or "Remediated". Learn More
boardMeetingMinutes	PassFailOrNotReported	"Pass" indicates that the organization keeps meeting minutes, and reports availability of these on IRS Form 990. Other possible values are "Fail" or "Not Reported". Learn More
distributes990ToBoard	PassFailOrNotReported	"Pass" indicates that the organization has provided copies of its Form 990 the governing body in advance of filing. Other possible values are "Fail" or "Not Reported". Learn More
conflictOfInterestPolicy	PassFailOrNotReported	"Pass" indicates that the organization has a conflict of interest policy in place. Other possible values are "Fail" or "Not Reported". Learn More
whistleBlowerPolicy	PassFailOrNotReported	"Pass" indicates that the organization has a whistleblower policy, as reported on IRS Form 990. Other possible values are "Fail" or "Not Reported". Learn More
recordsRetentionPolicy	PassFailOrNotReported	"Pass" indicates that the organization has a records retention and destruction policy, as reported on IRS Form 990. Other possible values are "Fail" or "Not Reported". Learn More
reportsCEOAndSalary	PassFailOrNotReported	"Pass" indicates that the organization included the CEO's name and compensation on Form 990. Other possible values are "Fail" or "Not Reported". Learn More
ceoCompensationProcedure	PassFailOrNotReported	"Pass" indicates that the organization has a consistent policy for determining CEO compensation, meeting certain best practices and standards established by Charity Navigator. Other possible values are "Fail" or "Not Reported". Learn More
compensatesBoard	PassFailOrNotReported	"Pass" indicates that the organization lists its board members, and does not compensate them for serving on its Board of Directors. Other possible values are "Fail" or "Not Reported". Learn More
independentAudit	PassFailOrPartial	"Pass" indicates that the organization's financial statements are prepared by an independent accountant with oversight from an audit committee. Other possible values are "Fail," "Partial," or "Not Reported". Learn More
independentBoard	PassFailOrNotReported	"Pass" indicates that independent Board members are a voting majority and also at least five in number. Other possible values are "Fail" or "Not Reported". Learn More

`Category`

In Charity Navigator's taxonomy, Category is the most general level of classification of Organziations.

Properties

Name	Type	Documentation
categoryID	string	Charity Navigator's unique identifier for the category.
categoryName	string	Name of the category.
causes	containing Cause * inverse of category	A list of specific causes, contained within this general category.
image	anyURI	URL for an image representing the Category.
charityNavigatorURL	anyURI	URL to the Category page on Charity Navigator's website.

`Cause`

In Charity Navigator's taxonomy, Cause is a second level of classification of an Organization, below Category.

Properties

Name	Type	Documentation
causeID	string	Charity Navigator's unique identifier for the cause.
causeName	string	Name of the cause.
category	container Category inverse of causes	The general category that contains this cause.
image	anyURI	URL for an image representing the Cause.
charityNavigatorURL	anyURI	URL to the Cause page on Charity Navigator's website.

`List`

A curated or generated list of organizations, published by Charity Navigator.

Properties

Name	Type	Documentation
listID	string	Unique ID for the list, assigned by Charity Navigator.
listName	string	Name of the list.
listType	string	A general classification of the list.
isCurrentlyFeatured	boolean	Boolean field, true is list is currently featured on site.
sortOrder	integer	If list is currently featured, the sort order it is currently displayed in.
listAbstract	string	Short list description.
listExplanation	string	Long list description.
listImageURL	anyURI	URL for an image representing the List.
charityNavigatorURL	anyURI	URL to the List page on Charity Navigator's website.
groups	containing OrganizationGroup *	Groups of organizations within the list. May be a single, unnamed group in the case of a flat list.

`OrganizationGroup`

A group of organization entries contained within a List. A composite "List of Lists" will have multiple named groups. A flat List of organizations will have a single, unnamed group.

Properties

Name	Type	Documentation
groupName	string	Optional name of the group.
groupDescription	string	Description of the group.
organizations	containing OrgListEntry *	Organization entries in the list.

`OrgListEntry`

The participation of a individual organization as a member of an OrganizationList.

Properties

Name	Type	Documentation
organization	Organization	Organization participating in the list.
rank	int	Rank of the organization within its containing group.
groupDescription	string	Description of the group.
groupName	string	Optional name of the group.

`Advisory`

A cautionary communication from Charity Navigator, advising of unusual events or behavior related to a known organization.

Properties

Name	Type	Documentation
advisoryID	string	Unique identifier for this advisory.
organization	Organization	The Organization that is the subject of the advisory.
severity	Severity	Severity of the Advisory.
datePublished	date	Date when the Advisory was first published.
dateRemoved	date	Date when the Advisory was removed. Advisory can be assumed to be active if dateRemoved is omitted.
dateModified	date	Date when the Advisory most recently modified.
sources	AdvisorySource +	Ordered list of Advisory Sources

`AdvisoryRollup`

A rolled up summary of the active advisory records of an organization. If the organization does not have any active advisory records, severity will have a NULL value

Properties

Name	Type	Documentation
severity	Severity	Rolled up severity level of all active advisory records for the organization. A NULL value means there are no active advisory records
active	Advisory *	Reference to all active advisory records for an organization.

`AdvisorySource`

A synopsis of an event or reference that triggers or provides additional details for an Advisory.

Properties

Name	Type	Documentation
datePublished	date	Date when the Advisory Source was published.
dateRemoved	date	Date when the Advisory Source was removed. The Advisory Source can be assumed to ba active if dateRemoved is omitted.
dateModified	date	Date when the Advisory Source was most recently modified.
publisher	string	Name of the Advisory Source publisher.
url	anyURI	URL referring to the Advisory Source.
summary	string	A summary description of the Advisory Source.

`ErrorInfo`

A generic structure to carry information about an error response from from the service.

Properties

Name	Type	Documentation
errorMessage	string

string Enumeration`Severity`

Enumeration describing three levels of severity.

Enumeration Constants

Name	Value	Documentation
HIGH	High	High severity.
MODERATE	Moderate	Moderate severity.
LOW	Low	Low severity.

string Enumeration`PassFailOrNotReported`

Enum for reporting of most accountability and transparency tests. The documentation for each metric should describe the criteria for a passing value.

Enumeration Constants

Name	Value	Documentation
PASS	Pass	Indicates that the organization meets the criteria to pass this accountability/transparency test. A favorable result.
FAIL	Fail	Indicates that the organization did not meets the criteria to pass this accountability/transparency test. An unfavorable result.
NOT_REPORTED	Not Reported	Indicates that the information required for this test is unavailiable, or that Charity Navigator has not scored the organization on this test.

string Enumeration`PassFailOrOptOut`

Enum for reporting of privacy tests within the accountability and transparency scoring system.

Enumeration Constants

Name	Value	Documentation
PASS	Pass	Indicates that the organization meets the criteria to pass this accountability/transparency test. A favorable result.
FAIL	Fail	Indicates that the organization did not meets the criteria to pass this accountability/transparency test. An unfavorable result.
OPT_OUT	Opt-Out	Indicates that the organization allows privacy, but not by default; only by the subject taking an explicit action to opt-out of information sharing.

string Enumeration`PassFailOrRemediated`

Enum for reporting of the material diversion of assets test, and potentially for similar tests, within the accountability and transparency scoring system.

Enumeration Constants

Name	Value	Documentation
PASS	Pass	Indicates that the organization meets the criteria to pass this accountability/transparency test. A favorable result.
FAIL	Fail	Indicates that the organization did not meets the criteria to pass this accountability/transparency test. An unfavorable result.
REMEDIATED	Remediated	Indicates that a material diversion of assets was reported, and subsequently corrected.
NOT_REPORTED	Not Reported	Indicates that the information required for this test is unavailiable, or that Charity Navigator has not scored the organization on this test.

string Enumeration`PassFailOrPartial`

Enum for reporting of accountability and transparency tests that have a partial or equivocal value. Each test property should describe the criteria for passing and partial values.

Enumeration Constants

Name	Value	Documentation
PASS	Pass	Indicates that the organization meets the criteria to pass this accountability/transparency test. A favorable result.
FAIL	Fail	Indicates that the organization did not meets the criteria to pass this accountability/transparency test. An unfavorable result.
PARTIAL	Partial	Indicates that certain criteria were met, but not all of the criteria required to pass the test unequivocally. Used on tests where Charity Navigator gives partial credit, or a smaller reduction of the Accountability Score than a failed test.
NOT_REPORTED	Not Reported	Indicates that the information required for this test is unavailiable, or that Charity Navigator has not scored the organization on this test.

Resource APIs

CharityNavigatorDataAPI (https://api.data.charitynavigator.org/v2)

OrganizationCollection Organizations OrganizationSummary

Resource Properties

Data Properties

Data Properties

Data Properties

OrganizationObject Organizations/{ein} Organization Default

Resource Properties

Parameters

Data Properties

Data Properties

Data Properties

RatingCollection Organizations/{ein}/Ratings Rating

Resource Properties

Parameters

Data Properties

Data Properties

Data Properties

RatingObject Organizations/{ein}/Ratings/{RatingID} Rating

Resource Properties

Parameters

Data Properties

Data Properties

Data Properties

AdvisoryCollection Organizations/{ein}/Advisories Advisory

Resource Properties

Parameters

Data Properties

Data Properties

Data Properties

AdvisoryObject Organizations/{ein}/Advisories/{AdvisoryID} Advisory

Resource Properties

Parameters

Data Properties

Data Properties

Data Properties

ListCollection Lists List

Resource Properties

Data Properties

Data Properties

Data Properties

ListObject Lists/{ListID} List

Resource Properties

Parameters

Data Properties

Data Properties

Data Properties

CategoryCollection Categories Category

Resource Properties

Data Properties

ActiveAdvisoryCollection Advisory AdvisorySummary

Resource Properties

Data Properties

Data Properties

Data Properties

Data Models

CharityNavigatorDataModel

Organization

Properties

AdvisorySummary

Properties

OrganizationSummary

Properties

Address

Properties

Representative

Properties

IRSClassification

Properties

string EnumerationDeductibilityType

Enumeration Constants

Rating

Properties

IconSet

Properties

PerformanceMetrics

Properties

FinancialRating

Properties

OrganizationCollection `Organizations` `OrganizationSummary`

OrganizationObject `Organizations/{ein}` `Organization` Default

RatingCollection `Organizations/{ein}/Ratings` `Rating`

RatingObject `Organizations/{ein}/Ratings/{RatingID}` `Rating`

AdvisoryCollection `Organizations/{ein}/Advisories` `Advisory`

AdvisoryObject `Organizations/{ein}/Advisories/{AdvisoryID}` `Advisory`

ListCollection `Lists` `List`

ListObject `Lists/{ListID}` `List`

CategoryCollection `Categories` `Category`

ActiveAdvisoryCollection `Advisory` `AdvisorySummary`

`Organization`

`AdvisorySummary`

`OrganizationSummary`

`Address`

`Representative`

`IRSClassification`

string Enumeration`DeductibilityType`

`Rating`

`IconSet`

`PerformanceMetrics`

`FinancialRating`

`AccountabilityRating`

`Form990`

`AccountabilityTests`

`Category`

`Cause`

`List`

`OrganizationGroup`

`OrgListEntry`

`Advisory`

`AdvisoryRollup`

`AdvisorySource`

`ErrorInfo`

string Enumeration`Severity`

string Enumeration`PassFailOrNotReported`

string Enumeration`PassFailOrOptOut`

string Enumeration`PassFailOrRemediated`

string Enumeration`PassFailOrPartial`