Essentials v2 API search examples

📘

POST Request Body

Essentials API is a POST call with the search parameters passed in the request body.

👍

Easily Build Your Search Query Using the API Docs

Take all the guess-work out of building your search query by using the built-in query generator on the Essentials API v2 API Docs page.

Search using an organization's EIN or name

Search for the organization by inserting the EIN into the "search_terms" parameter.

{
 "search_terms": "13-2875808"
}

Search for the organization using its name in the "search_terms" parameter.

{
 "search_terms": "University District Food Bank"
}

Search using keywords and filtering for city, state,

Search using keywords and filtering for city and state.

{
 "filters": {
 "geography": {
 "state": [
 "FL"
 ],
 "city": [
 "miami"
 ]
 }
 },
 "search_terms": "climate resilience"
}

Filter search results by NTEE major and minor codes

Filter results by using NTEE major and minor code filters. NTEE major codes are high-level, while NTEE minor codes are more discrete.

{
 "filters": {
 "organization": {
 "ntee_major_codes": [
 "T"
 ]
 }
 }
}

{
 "filters": {
 "organization": {
 "ntee_minor_codes": [
 "T50"
 ]
 }
 }
}

Filter by IRS classifications and organization standing

Narrow your search results by using filters that help you understand more about an organization's IRS classification and standing. Filter search results by IRS subsection, BMF Status, and Publication 78, while excluding revoked, defunct, and merged organizations.

{
 "filters": {
 "organization": {
 "subsection_codes": [
 "501(c)(3) Public Charity"
 ],
 "specific_exclusions": {
 "exclude_revoked_organizations": true,
 "exclude_defunct_or_merged_organizations": true
 },
 "bmf_status": true,
 "pub78_verified": true
 }
 }
}

Filter search results by IRS form types, audits, and financial metrics

Filter search results by IRS tax return form types, A-133 audits, and key financial metrics.

{
 "filters": {
 "organization": {
 "form_types": {
 "f990": true,
 "f990pf": false,
 "required_to_file_990t": true
 },
 "audits": {
 "a_133_audit_performed": true
 }
 },
 "financials": {
 "total_revenue": {
 "min": 5000000
 },
 "total_expenses": {
 "min": 3000000
 },
 "total_assets": {
 "max": 300000000
 }
 }
 }
}