Nonprofit IRS 990 Monitor

Store Positioning

Store title: Nonprofit IRS 990 Monitor

Short description: Monitor nonprofit IRS 990 public filings, filing dates, key fields, and change signals.

SEO title: Nonprofit IRS 990 Monitor — official public data extraction and monitoring

SEO description: Monitor nonprofit IRS 990 public filings, filing dates, key fields, and change signals. Use it to normalize official public data into clean Apify datasets with source-specific fields and report artifacts.

Categories: AUTOMATION, NEWS

Keywords: nonprofit, irs, 990, monitor, change monitor, public data, official/public-data actor

Fixed-Inclusive PPE Pricing

This actor uses pay-per-event pricing. Event prices include Apify platform usage; users are not expected to pay a separate platform-usage pass-through charge for the configured pricing model.

• Tier: D1 — Official/public-data actor
• Primary event: record-checked at $0.00908 base
• Default max charge: $15.00
• Store discounts: FREE/BRONZE base, SILVER discounted, GOLD deepest approved discount

Event set:

• actor-start: base $0.02000, GOLD $0.01760. Nonprofit Irs 990 Monitor: charged when actor start is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• record-checked: base $0.00908, GOLD $0.00799. Nonprofit Irs 990 Monitor: charged when record checked is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• event-detected: base $0.01300, GOLD $0.01140. Nonprofit Irs 990 Monitor: charged when event detected is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• report-generated: base $0.05000, GOLD $0.04400. Nonprofit Irs 990 Monitor: charged when report generated is completed. The price includes Apify platform usage; no separate usage pass-through is intended.

Public Task Concepts

• Compare IRS 990 financial totals for one EIN
• Monitor one nonprofit EIN from IRS 990 data
• Build an IRS 990 financial change digest
• Prioritize IRS 990 revenue, expense, and asset changes
• Export normalized IRS 990 filing rows

Normalize public IRS Form 990 filing data and identify changes for known nonprofit EINs.

What This Actor Does

Nonprofit IRS 990 Monitor parses supplied IRS Tax Exempt Organization Search index CSV, individual filing XML, JSON rows, or structured records. It normalizes EIN, organization name, tax year, filing type, filing date, object ID, tax period, revenue, expenses, assets, and source-file evidence.

Filters can match exact normalized EINs or organization-name fragments. When a row also includes previous revenue, expense, or asset values, the actor emits explicit financial change signals and an event-detected billing event before output.

What This Actor Does Not Do

• It does not access private tax records or nonpublic IRS systems.
• It does not provide tax, legal, accounting, investment, or compliance advice.
• It does not infer prior-period values when they are not supplied.
• It does not unpack IRS bulk ZIP archives; provide extracted CSV/XML content, structured rows, or a direct text response.
• It does not claim that a financial change is suspicious or improper.

Best Use Cases

• normalize IRS 990 index or filing records for a known EIN
• compare supplied current and previous financial totals
• monitor filing identity, tax year, and submission date
• export source-linked nonprofit filing rows
• route material changes for analyst review

Input Fields

Field	Type	Default	Notes
targets	array	one built-in filing record	Each target can contain records, csvText, XML/JSON text, or a direct text source URL.
urls	array	[]	Direct IRS text sources to fetch when fetchUrls is enabled.
eins	array	example EIN	Exact nine-digit EIN filters; punctuation is normalized.
organizationNames	array	[]	Case-insensitive organization-name fragments.
fetchUrls	boolean	false	Fetch and parse direct CSV, XML, or JSON text sources.
fetchTimeoutMs	integer	12000	Per-request timeout, capped at 30 seconds.
maxTargets	integer	1	Source-target cap.
maxItems	integer	5	Filing-row cap within normalized input.
includeReport	boolean	true	Writes JSON and Markdown report artifacts.

Example Input

{
  "targets": [
    {
      "sourceId": "example-990",
      "sourceUrl": "https://apps.irs.gov/pub/epostcard/990/xml/2025/",
      "records": [
        {
          "EIN": "12-3456789",
          "TAXPAYER_NAME": "Example Youth Foundation",
          "TAX_YEAR": 2025,
          "RETURN_TYPE": "Form 990",
          "SUB_DATE": "2026-06-28",
          "OBJECT_ID": "202612345678900001",
          "TOTREVENUE": 1480000,
          "TOTFUNCEEXPNS": 1010000,
          "TOTASSETSEND": 2100000,
          "previousRevenue": 1200000,
          "previousExpenses": 900000,
          "previousAssets": 1850000
        }
      ]
    }
  ],
  "eins": ["123456789"],
  "maxTargets": 1,
  "maxItems": 5,
  "includeReport": true
}

Output Fields

Each row contains ein, organizationName, taxYear, filingType, filingDate, revenue, expenses, assets, objectId, taxPeriod, matchedBy, changeSignals, sourceFileUrl, sourceError, and eventDetected, plus status, score, recommendation, timestamp, source identity, and pricing metadata.

An unmatched EIN or organization name produces an explicit no-match row. A fetch or parse failure produces a blocked row with sourceError; the actor does not substitute synthetic filing data.

Supported Source Shapes

• IRS TEOS index CSV or pipe-delimited text with quoted-cell support
• individual Form 990 XML with or without namespace prefixes
• JSON arrays or objects containing results, filings, or records
• structured records using IRS headers or normalized field names

Cost Control

• Start with one known EIN and one filing source.
• Pre-extract only the needed rows from bulk IRS files.
• Keep maxTargets and maxItems small for scheduled checks.
• Disable report artifacts when only dataset rows are needed.

Public Task Examples

• compare IRS 990 financial totals for one EIN
• monitor one nonprofit EIN from public filing data
• build a financial change digest
• prioritize revenue, expense, and asset deltas
• export normalized filing rows with source evidence

FAQ

Does this actor identify fraud or noncompliance?

No. It normalizes public filing evidence and computes supplied-period deltas. Qualified reviewers remain responsible for interpretation.

Why might a filing not match?

Verify the nine-digit EIN, organization spelling, tax year, and source file. IRS bulk datasets are released on schedules and may not contain a newly submitted filing immediately.

Limitations

IRS field availability varies by filing type and tax year. XML structures outside the supported identity and financial tags may require preprocessing. Change signals require explicit previous values and should be checked against the source filing.

Source And Safety Notes

The IRS distributes Form 990 series data through Tax Exempt Organization Search bulk indexes and filing XML. Use only public IRS data or records you are authorized to process; do not submit credentials or private taxpayer data.

Changelog

• 2026-07-10: Added IRS CSV/XML/JSON parsing, EIN and name filtering, filing normalization, financial change signals, charge-limit regression coverage, and honest source-error rows.