Nonprofit Search API examples
Make the most of the Nonprofit Search API with these helpful examples
The following example calls utilize the RESTful v1 endpoint of the Nonprofit Search API and should be made as a POST call with the search parameters passed in the request body.
Easily Build Your Nonprofit Search Query
Build your own custom search queries using the built-in query generator on the Nonprofit Search API v1 docs page.
A GraphQL version of the Nonprofit Search API is also available, allowing you to specify both a search query and the fields returned. Learn more about that here.
Search using an organization's EIN or name
Search for an organization using its EIN.
{
"filters": {
"organization": {
"ein": [
"13-2875808"
]
}
}
}
Search for an organization using its name.
{
"filters": {
"organization": {
"names": [
{
"name": "Candid",
"name_type": "main"
}
]
}
}
}
Search using keywords and filtering for city, state, and search terms
Search using keywords and filtering for city and state. Using the auto suggestion parameter will return correct results even if there are typos in the search term.
{
"search_terms": "climate resilience",
"auto_suggestion": true,
"filters": {
"geography": {
"admin1_code": [
"FL"
],
"city": [
"Miami"
]
}
}
}
Filter results by country
Search for organizations in specific countries.
{
"filters": {
"geography": {
"country_code": [
"US",
"CA"
]
}
}
}
Filter search results by Candid's taxonomy
Filter results by using Candid's taxonomy, up to 25 codes at a time.
The below example searches for organizations by the subject area they work in and the population they serve. When two filters are used, AND operator logic is applied. This example will return organizations who match college preparation AND young adults.
{
"filters": {
"organization": {
"subject_codes": ["SB0902"], /*college preparation*/
"population_served_codes": ["PA0201"] /*young adults*/
}
}
}
In the example below, OR operator logic is applied within the same filter. This example will return organizations who match college preparation OR secondary education
{
"filters": {
"organization": {
"subject_codes": ["SB0902","SB0304"] /*college preparation or secondary education*/
}
}
}
This example will return organizations who match the following logic: (college preparation OR secondary education) AND young adults.
{
"filters": {
"organization": {
"subject_codes":["SB0902","SB0304"], /*college preparation or secondary education*/
"population_served_codes":["PA0201"] /*young adults*/
}
}
}
Search for organizations by type. The below example returns organizations that are public charities or fiscally-sponsored organizations.
{
"filters": {
"organization": {
"organization_type_code":["EA04","EE"] /*public charities or fiscally-sponsored organizations*/
}
}
}
Filter organizations by the demographics of their leader
Identify organizations with a leader of a specific demographic group. The below example search filters for organization with a woman and BIPOC leader.
{
"filters": {
"organization": {
"demographics_leader": [
"woman_leader",
"bipoc_leader"
]
}
}
}
Search for organizations by the last time their data was updated
Search for new data as it happens. Below is an example search for any updates that occurred between January 1st and February 1st of 2024.
{
"filters": {
"last_updated": {
"start_date": "2024-01-01T01:01:01:01",
"end_date": "2024-02-01T01:01:01:01",
"date_type": "last_modified"
}
}
}
Monitor organizations for updates
Monitor a list of up to 100 organizations for new or updated data. Enter up to 100 EINs in search terms, separated by spaces, in combination with any last updated date. The below example search checks 100 organizations for any changes within the last month.
{
"search_terms": "90-1035078 03-0286303 38-6430820 82-0469910 57-1011251 20-0745585 20-3549055 86-1159754 23-7513505 84-2358709 47-2065606 56-2574991 24-0835175 27-5044130 61-1217886 52-1219079 94-1377252 84-1496351 20-1429156 56-2361393 82-6006687 36-4642488 58-1698703 82-4600119 20-4664249 83-1877405 95-3641380 22-2487376 38-2808532 83-3984485 73-6109579 23-7134478 85-1923418 26-1348062 37-6079313 85-2819881 22-6167169 90-0541946 41-0884473 81-2613711 23-7224051 11-2899020 58-0899717 94-2443651 16-1391026 16-1665637 81-0617686 73-0788063 37-0946061 85-4290470 63-0985647 14-1842635 45-2591375 74-3024063 81-3559678 01-0356240 23-7593168 30-0753447 52-2143108 93-0358258 36-4527281 82-0948527 52-2407099 65-0071524 82-0912118 43-1628572 27-3245756 84-1603569 31-1581043 45-5363273 94-1654116 46-0422304 86-1365488 86-1468780 48-1076239 95-4362747 84-2228458 59-3699601 46-2810910 34-1526090 46-1575286 45-1541211 81-1246737 71-6056090 71-0591875 23-7210173 90-0070079 47-4300296 26-0335296 20-8983968 81-1677986 88-1718646 33-0766760 47-3043818 63-6183677 85-2920675 80-0719588 86-2210754 84-3634826 45-2150756",
"filters": {
"last_updated": {
"start_date": "2024-01-01T00:00:00",
"end_date": "2024-07-01T00:00:00",
"date_type": "last_modified"
}
}
}
Filter by IRS classifications and organization standing
Narrow your search results based on an organization's IRS classification and standing. In the below example, identify active public charities by filtering search results by IRS subsection, BMF Status, and Publication 78, and excluding revoked, defunct, and merged organizations.
{
"filters": {
"organization": {
"subsection_codes": [
"501(c)(3) Public Charity"
],
"properties": {
"bmf_status": true,
"pub78_verified": true,
"exclude_revoked_organizations": true,
"exclude_defunct_organizations": true,
"exclude_merged_organizations": true
}
}
}
}
Filter by financial metrics
Filter search results by key financial metrics and IRS form type. The below example identifies organizations that file an IRS Form 990 and have revenue between $10M and $100M.
{
"filters": {
"financials": {
"most_recent_year": {
"form_types": {
"f990": true
},
"total_revenue": {
"min": 10000000,
"max": 100000000
}
}
}
}
}
Filter by group exemption and relationship type
Filter search results to return all child organizations within a group exemption.
{
"filters": {
"organization": {
"group_exemption":
"0123"
,
"properties": {
"subordinate": true
}
}
}
}
Filter by organizations with a website and contact information
Filter search results to return only organizations that have a website or contact information available.
{
"filters": {
"organization": {
"properties": {
"has_url": true,
"has_contact": true
}
}
}
}
Filter organizations by UN SDG code
Filter organizations by United Nations Sustainable Development Goals (SDGs).
{
"filters": {
"organization": {
"sustainable_development_goals": ["1"] /* no poverty */
}
}
}
Updated 3 months ago