IRS Auto-Revocation List Scraper

Download and parse the IRS Tax Exempt Organization (TEOS) auto-revocation bulk data file — the authoritative public record of every nonprofit that has lost or regained federal tax-exempt status.

What it does

The IRS automatically revokes a nonprofit's tax-exempt status when the organization fails to file required annual returns (Form 990, 990-EZ, or 990-N) for three consecutive years. This scraper downloads the full auto-revocation list from the IRS Tax Exempt Organization Search (TEOS) system and returns structured records for every affected organization.

The file is updated monthly by the IRS and covers over 1,000,000 historical revocations going back to 2007, including organizations that were later reinstated.

Use cases

• Grantmaker compliance — verify a charity has not been auto-revoked before disbursing funds
• DAF sponsor re-verification — monthly re-check of all donor-advised fund recipient organizations
• Charity-verification SaaS — integrate up-to-date revocation status into donor and compliance products
• CRM / donor data hygiene — flag or remove revoked organizations from your donor database
• Monthly delta reporting — schedule a monthly run and identify newly-revoked or newly-reinstated orgs by revocation_date or exemption_reinstatement_date

Output fields

Field	Description
ein	Employer Identification Number
organization_name	Name of the tax-exempt organization
doing_business_as	DBA name, if any
organization_address	Street address
city	City
state	US state abbreviation (or country code for foreign orgs)
zip	ZIP or postal code
country	Country (blank for US domestic)
exemption_type	Type of exemption — e.g. 501(c)(3), 501(c)(4)
revocation_date	Date tax-exempt status was automatically revoked
revocation_posting_date	Date the revocation was posted to the IRS website
exemption_reinstatement_date	Date tax-exempt status was reinstated (blank if still revoked)
status	auto-revoked or reinstated
tax_period	Tax period (not present in the bulk file; always blank)
source_file	Name of the source ZIP file downloaded from IRS
first_seen	ISO-8601 timestamp of when this record was scraped

Input

Field	Type	Default	Description
maxItems	integer	—	Maximum number of records to return. Leave blank to return all records (1M+).

Notes

• No proxy required. The IRS bulk-data file is a public static download with no geo-restriction or anti-bot measures.
• Monthly cadence. Schedule a run each month after the IRS updates the file (typically mid-month) to surface newly-revoked and newly-reinstated organizations.
• Memory. This actor requires at least 512 MB of memory to decompress and parse the bulk data file.
• Full corpus run time. A complete run over all 1M+ records takes approximately 5–10 minutes.
• Reinstatement detection. The status field is derived: if exemption_reinstatement_date is populated, the status is reinstated; otherwise it is auto-revoked. Filter on status = "reinstated" to find organizations that regained their exemption.