Essentials v2 API search examples
Make the most of Essentials v2 organization search with these helpful 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
}
}
}
}
Updated about 2 years ago