IRS Tax Exempt Organization Scraper

Search and retrieve data on US tax-exempt nonprofit organizations directly from the IRS Exempt Organizations Business Master File (EO BMF) — the official IRS dataset containing over 1.9 million 501(c) organizations.

No API key required. Data is sourced from the IRS public bulk data download files.

What This Actor Does

• Search organizations by name (partial match, case-insensitive)
• Filter by US state, NTEE classification code, 501(c) subsection type, or deductibility status
• Lookup specific organizations by EIN (Employer Identification Number)
• Returns rich metadata: EIN, legal name, location, 501(c) type, NTEE code, ruling date, deductibility status, and more

Input

Field	Type	Description
mode	select	searchOrganizations (default) or getByEIN
searchQuery	string	Organization name to search (partial, case-insensitive)
state	select	2-letter state code to filter results (blank = all states)
nteeCode	string	NTEE code prefix (e.g. H for Health, B for Education)
deductibilityStatus	select	Filter by deductibility: All, Fully Deductible (1), Generally Deductible (2), Special Rules (4)
subsectionCode	string	501(c) subsection number (e.g. 3 for 501(c)(3))
eins	array	List of EINs for getByEIN mode
maxItems	integer	Max records to return (1–500, default 50)

Example Inputs

Search cancer research organizations in California:

{
  "mode": "searchOrganizations",
  "searchQuery": "cancer research",
  "state": "CA",
  "maxItems": 50
}

Lookup organizations by EIN:

{
  "mode": "getByEIN",
  "eins": ["53-0204600", "13-1837418"],
  "maxItems": 10
}

Find all 501(c)(3) health organizations in Texas:

{
  "mode": "searchOrganizations",
  "state": "TX",
  "subsectionCode": "3",
  "nteeCode": "H",
  "maxItems": 100
}

Output

Each record contains:

Field	Description
ein	EIN in XX-XXXXXXX format
einRaw	9-digit raw EIN
organizationName	Legal organization name
street	Street address
city	City
state	2-letter state code
zipCode	ZIP code
subsectionCode	501(c) subsection code (e.g. 03 for 501(c)(3))
subsectionDescription	Human-readable 501(c) type
deductibilityCode	Deductibility code (1, 2, or 4)
deductibilityDescription	Deductibility status description
nteeCode	NTEE classification code
ruling	IRS ruling date (YYYYMM)
affiliationCode	Group affiliation code
affiliationDescription	Affiliation description
classificationCode	Classification code
foundationCode	Foundation code
statusCode	Exempt status code
taxPeriod	Tax period (YYYYMM)
sourceUrl	IRS bulk data source URL
irsUrl	Link to IRS TEOS search page for this org
recordType	Always "organization"
scrapedAt	ISO 8601 timestamp

Sample Output Record

{
  "ein": "53-0204600",
  "einRaw": "530204600",
  "organizationName": "AMERICAN RED CROSS",
  "street": "2025 E STREET NW",
  "city": "WASHINGTON",
  "state": "DC",
  "zipCode": "20006",
  "subsectionCode": "03",
  "subsectionDescription": "501(c)(3) - Charitable, Religious, Educational",
  "deductibilityCode": "1",
  "deductibilityDescription": "Contributions are deductible",
  "nteeCode": "P20",
  "ruling": "193402",
  "affiliationCode": "3",
  "affiliationDescription": "Independent organization",
  "classificationCode": "1000",
  "statusCode": "01",
  "taxPeriod": "202312",
  "sourceUrl": "https://www.irs.gov/charities-non-profits/tax-exempt-organization-search-bulk-data-downloads",
  "irsUrl": "https://apps.irs.gov/app/eos/detailsPage?ein=530204600...",
  "recordType": "organization",
  "scrapedAt": "2026-05-30T10:00:00+00:00"
}

Data Source

Data is sourced from the IRS Exempt Organizations Business Master File Extract — updated monthly by the IRS. The dataset contains all organizations with IRS tax-exempt status. See the IRS EO BMF page for more details.

NTEE Codes

Common NTEE code prefixes:

• A — Arts, Culture, Humanities
• B — Education
• C — Environmental Quality
• D — Animal-Related
• E — Health Care
• F — Mental Health
• G — Disease, Medical Research
• H — Medical Research
• I — Crime, Legal Related
• J — Employment
• K — Food, Agriculture
• L — Housing, Shelter
• M — Public Safety
• N — Recreation, Sports
• O — Youth Development
• P — Human Services
• Q — International
• R — Civil Rights, Social Action
• S — Community Improvement
• T — Philanthropy, Voluntarism
• U — Science and Technology
• V — Social Science
• W — Public Affairs
• X — Religion Related
• Y — Mutual Benefit Organizations
• Z — Unknown

FAQs

Q: Does this require an API key? No. Data is sourced from publicly available IRS bulk download files.

Q: How current is the data? The IRS EO BMF is updated monthly. This actor always fetches the latest version.

Q: Can I search by EIN? Yes. Use getByEIN mode and provide a list of EINs in the eins field.

Q: What does deductibility code 4 mean? Code 4 means contributions may be deductible subject to special rules (e.g., private foundations with restrictions). Always consult a tax advisor.

Q: What states are supported? All 50 US states plus DC.

Q: What is NTEE code? The National Taxonomy of Exempt Entities (NTEE) is a classification system for nonprofit organizations developed by the IRS and the National Center for Charitable Statistics.