improved

12.09.2022 - Essentials API v3 released

The best nonprofit search engine​ just got better.

Users can make searches more relevant and real-time with access to new filters.

  • Power your nonprofit search for donors to find organizations they are most interested in using Candid's Philanthropy Classification System
  • Search for organizations with recently updated data to keep your records up to date. Never miss an update again. ​
  • Find organizations who have submitted demographic, equity and inclusion data to Candid to discover who to give to​
  • Find and sort search results by location for users to discover organizations closest to them

View the /essentials/v3 API docs to learn more.

Expanded list of features include:

Search features

  • Filter on Candid’s Philanthropy Classification System using subject and populations served facet
  • Filter for organizations who have submitted demographic, equity and inclusion data to Candid​
  • Search for real-time updates using start and end dates when:
    • Organizations earn their seal
    • Organizations update their Candid profile​
    • Organizations submit demographic data​
    • Candid processes 990 financials ​posted from IRS sources
  • Search and sort organization results by the ruling year an organization became a registered nonprofit​
  • Search and sort organization results by zip code distance to the user​

Data response

  • A restructured response makes it easier to display taxonomy descriptions and financials
  • Ruling year, profile year, profile link, and seal of transparency logo are provided in the response
  • DEI submitted flag is returned in the response
  • All modification dates are returned in the response

Example searches

I am a grant maker who wants to find organizations that updated their Candid profile over the last 7 days so that I know which organization records I need to update

{
    "filters": {
        "last_updated": {
            "start_date": "2022-11-10T00:00:00",
            "end_date": "2022-11-17T23:59:59",
            "date_type": "profile_last_modified"
        }
    }
}

I am a grants manager who wants to see organizations who submitted demographic data to Candid last month so that I can update my records appropriately

{
    "filters": {
        "organization": {
            "properties": {
                "dei_submitted": true
            }
        },
        "last_updated": {
            "start_date": "2022-10-01T00:00:00",
            "end_date": "2022-10-31T23:59:59",
            "date_type": "dei_last_modified"
        }
    }
}

I am a donor who wants to find organizations serving specific subjects and populations that received their nonprofit ruling in the last 3 years so that I can discover new organizations to give to in the areas I care about

{
     "sort": {
          "sort_by": "ruling_year",
          "sort_order": "desc"
     },
     "filters": {
          "organization": {
               "subject_codes": [
                    "SN04"
               ],
               "population_served_codes": [
                    "PG0302"
               ],
               "ruling_year": {
                    "min": 2019,
                    "max": 2022
               }
          }
     }
}

I am a grants manager who wants to automatically monitor grantee organizations when new data is available so that I can be alerted about/ automatically update all changes on grantees daily

{
    "filters": {
        "last_updated": {
            "start_date": "2022-11-01T00:00:00",
            "end_date": "2022-11-01T23:59:59",
            "date_type": "last_modified"
        }
    },
    "search_terms": "22-2842846 83-2688014 27-1734337 81-3465689 25-1404779 01-0814204 02-0274509 02-0501917 13-3156445 43-1741457 "
}

I am a donor who wants to find nonprofits closest to me who support my subject area of interest

{
     "sort": {
          "sort_by": "distance",
          "sort_order": "desc"
     },
     "filters": {
          "geography": {
               "zip": 10005,
               "radius": 50
          },
          "organization": {
               "subject_codes": [
                    "SN04"
               ]
          }
     }
}

I am a financial analyst who wants to find all financial updates for 990 EZ filers, last month, so that I can make sure my system of record is up to date

{
    "filters": {
        "financials": {
            "most_recent_year": {
                "form_types": {
                    "f990ez": true
                }
            }
        },
        "last_updated": {
            "date_type": "financials_last_modified",
            "start_date": "2022-10-01",
            "end_date": "2022-10-31"
        }
    }
}

To display, pull, or process the organization's data changes, the Premier API should be called to get those details.

Want to try it out?

Current Essentials API customers can upgrade to v3 at any time.

Try it out for free and contact us to get a quote