{ "openapi": "3.1.0", "info": { "title": "Nonprofits API", "version": "1.0.0", "description": "Verify any US nonprofit by EIN: IRS tax-exempt status and whether donations are deductible.\n\nVerify any US nonprofit in one call: whether an EIN belongs to a real, IRS-recognized tax-exempt organization, and whether donations to it are deductible — with the basis for the answer stated (listed in IRS Publication 78, or the Business Master File deductibility code). Built on the IRS's own monthly source-of-truth files: all 1,957,340 organizations in the Exempt Organizations Business Master File, cross-flagged against the 1.4 million EINs in Publication 78. Every record carries the decoded 501(c) subsection, foundation type (church, school, hospital, publicly supported charity, private foundation...), NTEE activity classification with its category, ruling date, full address, and the organization's latest reported assets, income and revenue. An EIN that is not in the master file answers tax_exempt: false — the actionable result for a donation platform, matching-gift program or grant system, not a bare error. Search 1.96M organizations by name, state, city, zip, NTEE code or category, 501(c) subsection, foundation type, deductibility or revenue range; roll up the sector by NTEE category or state with organization counts and total revenue. EINs accept the hyphenated form (53-0196605). Self-hosted dataset refreshed from the IRS monthly publication cycle — no third-party calls at request time.", "contact": { "name": "Data and APIs", "url": "https://dataandapis.com/contact" }, "termsOfService": "https://dataandapis.com/terms-of-service", "license": { "name": "Data and APIs Terms of Service", "url": "https://dataandapis.com/terms-of-service" }, "x-logo": { "url": "https://dataandapis.com/images/nonprofits.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/nonprofits" }, "servers": [ { "url": "https://api-nonprofits.dataandapis.com" } ], "tags": [ { "name": "Data", "description": "Nonprofits API belongs to the Data category of the Data and APIs catalog." } ], "paths": { "/v1/sources": { "get": { "operationId": "dataSources", "summary": "Data Sources", "description": "Data Sources endpoint of the Nonprofits API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/nonprofits/data-sources" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "count": 2, "sources": [ { "slug": "irs-eo-bmf", "name": "IRS Exempt Organizations Business Master File", "publisher": "US Internal Revenue Service", "licence": "US Government work - no copyright", "source_url": "https://www.irs.gov/charities-non-profits/exempt-organizations-business-master-file-extract-eo-bmf", "file_url": "https://www.irs.gov/pub/irs-soi/eo1.csv", "cadence": "monthly", "record_count": 1957340, "retrieved_at": "2026-08-29", "updated_at": "2026-08-29 05:28:12" }, { "slug": "irs-pub78", "name": "IRS Publication 78 (deductible contributions list)", "publisher": "US Internal Revenue Service", "licence": "US Government work - no copyright", "source_url": "https://www.irs.gov/charities-non-profits/tax-exempt-organization-search-bulk-data-downloads", "file_url": "https://apps.irs.gov/pub/epostcard/data-download-pub78.zip", "cadence": "monthly", "record_count": 1412318, "retrieved_at": "2026-08-29", "updated_at": "2026-08-29 05:28:12" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/nonprofits/categories": { "get": { "operationId": "nonprofitCategories", "summary": "Nonprofit Categories", "description": "Nonprofit Categories endpoint of the Nonprofits API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/nonprofits/nonprofit-categories" }, "parameters": [ { "name": "state", "in": "query", "required": false, "schema": { "type": "string" }, "example": "NY" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "count": 6, "categories": [ { "code": "X", "category": "Religion-Related", "organizations": 15925, "total_revenue": 2116544637 }, { "code": "A", "category": "Arts, Culture & Humanities", "organizations": 10598, "total_revenue": 9067255543 }, { "code": "B", "category": "Education", "organizations": 10248, "total_revenue": 86583911128 }, { "code": "T", "category": "Philanthropy, Voluntarism & Grantmaking Foundations", "organizations": 9523, "total_revenue": 13929576548 }, { "code": "P", "category": "Human Services", "organizations": 8782, "total_revenue": 21913920111 }, { "code": "N", "category": "Recreation & Sports", "organizations": 5593, "total_revenue": 1901317550 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/nonprofits/states": { "get": { "operationId": "nonprofitsByState", "summary": "Nonprofits By State", "description": "Nonprofits By State endpoint of the Nonprofits API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/nonprofits/nonprofits-by-state" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "count": 6, "states": [ { "state": "CA", "count": 201973, "deductible": 179110 }, { "state": "TX", "count": 153779, "deductible": 136140 }, { "state": "NY", "count": 124214, "deductible": 109040 }, { "state": "FL", "count": 113451, "deductible": 103765 }, { "state": "PA", "count": 81596, "deductible": 68064 }, { "state": "OH", "count": 76668, "deductible": 64039 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/nonprofits/random": { "get": { "operationId": "randomNonprofits", "summary": "Random Nonprofits", "description": "Random Nonprofits endpoint of the Nonprofits API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/nonprofits/random-nonprofits" }, "parameters": [ { "name": "amount", "in": "query", "required": false, "schema": { "type": "string" }, "example": "3" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "count": 3, "results": [ { "ein": "870789674", "name": "NUCLEAR POWER PLANT SECURITY OFFICERS OF AMERICA LOCAL ONE", "city": "HANCOCKS BRG", "state": "NJ", "subsection": { "code": "05", "label": "501(c)(5)" }, "ntee": "Y99", "ntee_category": "Mutual & Membership Benefit", "revenue": 181151, "deductible": false }, { "ein": "870789970", "name": "THE MASONIC BUILDING CORPORATION", "city": "GRISWOLD", "state": "CT", "subsection": { "code": "03", "label": "501(c)(3)" }, "ntee": "Y114", "ntee_category": "Mutual & Membership Benefit", "revenue": 49293, "deductible": true }, { "ein": "870790139", "name": "ARTS HOUSE SCHOOLS INC", "city": "BROOKLYN", "state": "NY", "subsection": { "code": "03", "label": "501(c)(3)" }, "ntee": "A25", "ntee_category": "Arts, Culture & Humanities", "revenue": 408725, "deductible": true } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/nonprofits": { "get": { "operationId": "searchNonprofits", "summary": "Search Nonprofits", "description": "Search Nonprofits endpoint of the Nonprofits API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/nonprofits/search-nonprofits" }, "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "city", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deductible", "in": "query", "required": false, "schema": { "type": "string" }, "example": "true" }, { "name": "foundation", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "20" }, { "name": "max_revenue", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "min_revenue", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "ntee", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "string" }, "example": "1" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "food bank" }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string" }, "example": "CA" }, { "name": "subsection", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "zip", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "total": 61, "page": 1, "limit": 20, "count": 3, "results": [ { "ein": "953135649", "name": "LOS ANGELES REGIONAL FOOD BANK", "city": "VERNON", "state": "CA", "subsection": { "code": "03", "label": "501(c)(3)" }, "ntee": null, "ntee_category": null, "revenue": 273886894, "deductible": true }, { "ein": "943041517", "name": "SAN FRANCISCO FOOD BANK", "city": "SAN FRANCISCO", "state": "CA", "subsection": { "code": "03", "label": "501(c)(3)" }, "ntee": null, "ntee_category": null, "revenue": 167084763, "deductible": true }, { "ein": "942418054", "name": "FOOD BANK CONTRA COSTA AND SOLANO", "city": "CONCORD", "state": "CA", "subsection": { "code": "03", "label": "501(c)(3)" }, "ntee": "K310", "ntee_category": "Agriculture, Food & Nutrition", "revenue": 157214074, "deductible": true } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/nonprofits/{ein}": { "get": { "operationId": "verifyNonprofit", "summary": "Verify Nonprofit", "description": "Verify Nonprofit endpoint of the Nonprofits API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/nonprofits/verify-nonprofit" }, "parameters": [ { "name": "ein", "in": "path", "required": true, "schema": { "type": "string" }, "example": "53-0196605" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "tax_exempt": true, "ein": "530196605", "name": "AMERICAN NATIONAL RED CROSS", "also_known_as": "SHARED SERVICES CENTER", "in_care_of": null, "address": { "street": "431 18TH ST NW", "city": "WASHINGTON", "state": "DC", "zip": "20006-5310" }, "deductible": { "verdict": true, "basis": "Listed in IRS Publication 78", "bmf_code": { "code": "1", "label": "Contributions are deductible" }, "publication_78": { "listed": true, "codes": [ { "code": "PC", "label": "Public charity" } ] } }, "subsection": { "code": "03", "label": "501(c)(3)" }, "foundation": { "code": "15", "label": "Organization benefitting a college or university" }, "organization_type": { "code": "1", "label": "Corporation" }, "exempt_status": { "code": "01", "label": "Unconditional exemption" }, "ruling_date": "1938-12", "group_exemption": null, "ntee": { "code": "P210", "category": "Human Services" }, "financials": { "as_of_tax_period": "2025-06", "assets": 5052941623, "income": 4608946426, "revenue": 3916983933 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call." } } }, "security": [ { "ApiKey": [] } ] }