US HRSA Health Center / Look-Alike Site Portfolio Status Event Monitor

Watch a book of HRSA Health Center Numbers and/or BPHC site keys and emit typed Active / Inactive-or-removed / site-type / location-setting events when the official data.hrsa.gov Health Center Service Delivery and Look-Alike Sites CSV changes — not another NPPES lead dump, not a CMS PPEF Medicare enrollment twin, not an EHBs authenticated portal scrape, and not unpaid 340B OPAIS.

What this Actor does

1. Takes your watchlist (siteKeys / bphcNumbers and/or healthCenterNumbers).
2. In live mode, downloads the official HRSA Service Delivery / Look-Alike Sites CSV once.
3. Expands Health Center Numbers to all sites under each number; diffs BPHC site keys against a durable Key-Value Store checkpoint.
4. Pushes only material status/type events for sites on your book (PPE), plus one non-billable RUN_STATUS health row.

First observation of a site is baseline only (no charge). Quiet extracts ≈ $0 product charges.

Coverage honesty (read this)

In scope	Out of scope
Official HRSA data.hrsa.gov Health Center Service Delivery and Look-Alike Sites CSV	EHBs authenticated operator portal scrape
FQHC and Look-Alike published sites	Unpaid 340B OPAIS covered-entity scrape (different job)
Typed events for watched Health Center Numbers / BPHC site keys only	Nationwide “download every site and bill rows” dump SKU
Site Status Description, location type/setting, operator fields on the public extract	Full private EHBs case-file / Form 5B workflow state
HRSA publish cadence (daily per catalog claims)	Intra-day EHBs UI alerts
Official HRSA HTTP CSV (no key)	NPPES directory dump; CMS PPEF / PECOS Medicare enrollment twin (#27)

Limitation: Public CSV is a snapshot of published sites, not the full private EHBs case file — absence/terminated in extract ≠ every possible internal HRSA workflow state. Cite HRSA + extract date (as_of / fetchedAt).

Input

Field	Notes
siteKeys	BPHC Assigned Numbers (unique site keys), e.g. BPS-H80-000108.
bphcNumbers	Alias for siteKeys.
healthCenterNumbers	Org-level Health Center Numbers (e.g. H80CS00046); live mode expands to all sites under each.
signalGroups	status, site_type, location_setting. Default: all three.
sourceMode	fixture (default — Store health) or live (HRSA CSV; no API key).
emitFixtureDemoEvents	Default false. Only enable for local demos; Store auto-tests must stay false.
csvUrl	Optional pin to a specific HRSA CSV URL.

Output events (billable)

event_type	When
HRSA_SITE_ACTIVE	Site becomes Active / reappears on the extract after missing
HRSA_SITE_INACTIVE_OR_REMOVED	Site leaves Active or disappears from the public CSV snapshot
HRSA_SITE_TYPE_CHANGED	Location type / Health Center type description / operator flips
HRSA_LOCATION_SETTING_CHANGED	Location setting description flips

Every successful run also pushes RUN_STATUS with billable: false (FIXTURE_HEALTH / MONITOR_IDLE / CATCHUP_COMPLETE / HEALTH_OK).

Pricing (PPE)

Event	Price
hrsa-site-status-event-delivered	$0.02 ($20 / 1k)
apify-actor-start	$0.00005

You pay when a site on your watchlist has a material Active/Inactive/type/location-setting change and we deliver it. Not charged: baselines, quiet books, duplicates, invalids, RUN_STATUS, fixture health, full CSV rows not on the book.

Modes

• Fixture (default): no network; emits RUN_STATUS / FIXTURE_HEALTH only → 0 product charges (Store daily auto-test safe).
• Live: official HRSA public CSV — no key required.

Legal

HRSA data.hrsa.gov public dataset for reuse. Product default = Health Center Number + BPHC site key + site identifiers + status/type/location/operator fields (facility/org data; minimise unnecessary phone if customer supplies ID-only book). Cite HRSA + extract date.

Not this product

• NPPES / National Provider Identifier directory dumps (different job).
• CMS PPEF / PECOS Medicare Fee-For-Service enrollment monitors (Phase 3 #27 twin — wrong job).
• EHBs authenticated Form 5B / scope UI scrape.
• Unpaid 340B OPAIS covered-entity scrape (prior BACKLOG; different job).
• One-shot findahealthcenter city search.
• Nationwide CSV row dump billed as product events.

Example input (live baseline)

{
  "siteKeys": ["BPS-H80-000108", "BPS-H80-000209"],
  "healthCenterNumbers": ["H80CS00046"],
  "signalGroups": ["status", "site_type", "location_setting"],
  "sourceMode": "live",
  "emitFixtureDemoEvents": false,
  "resumeFromCheckpoint": true,
  "maxRunSeconds": 120,
  "maxEvents": 500
}

Example input (Store fixture health)

{
  "siteKeys": ["BPS-H80-000108"],
  "sourceMode": "fixture",
  "emitFixtureDemoEvents": false
}