Healthcare · data product
ALF Citations Spine
Request access Measure guide API docs All data products
What this dataset is
Assisted living is not CMS Nursing Home Compare. There is no national citation file and no shared F-tag system. Each state (and DC) licenses its own settings under different names, runs its own survey rules, and publishes inspection history — if at all — as portals, PDFs, open-data dumps, or FOIA-only paths. Fifty-one different source shapes is the product problem: without a spine, every analytics team rebuilds the same one-off scrapers and still cannot compare states honestly.
We solve that with a state-adapter pipeline, not a single national scrape.
For each jurisdiction we acquire full source extracts, profile the native schema, and maintain an explicit field map into a fixed report contract — facility identity, finding/citation rows, state tag codes, native severity language, survey dates, complaint and open-like flags, and full provenance (source system, file/URL, raw payload for reprocess).
Transform and validate run fail-closed; we load only contract-clean rows into a universal model (DimFacility, FactFinding, DimTag, DimStateCoverage) while keeping state-native files on disk.
What you license is that unified spine: ~44.6k facilities nationally, findings and tags where states publish them, rolling R12 windows, and a coverage level per state (bulk findings, partial, or FOIA blackout). We never invent citations for dark states or relabel state tags as CMS F-tags. Explorer through Enterprise tiers provision API keys and a base URL after we scope use case — samples and docs are available before purchase so you can see the grain first.
Spine snapshot
Figures as of the 2026-07-29 production load (rounded for marketing; live counts move with refresh).
Coverage by level
We do not invent citations for dark states. Coverage level is part of the product.
| Level | Meaning | Count | Risk KPIs |
|---|---|---|---|
A_bulk_findings |
Full citation grain — national KPIs safe for volume metrics | 30 | Yes (with honesty rules) |
B_partial_findings |
Partial / thin public findings | 3 | Limited |
F_foia_blackout |
Selectable state; facility-level findings pending public records | 13 | No — status only |
What the spine includes
| Domain | You get |
|---|---|
| Facilities | National roster keys, state, ownership/license type where sourced, capacity when present |
| Findings / citations | Survey-linked finding rows, citation grain flags, complaint / open-like signals, native severity text |
| Tags | State tag codes and a unified tag dictionary for analytics |
| Coverage | Per-state coverage level so consumers never treat FOIA blackouts as clean data |
| Time windows | Rolling R12 and historical rows where states publish them |
Sample extracts (proof of grain)
Live slices from the production ALF spine — capped on purpose so you can inspect real columns without a full license. Minnesota is used as a high-volume A-bulk example for facility / findings / tag samples. Coverage is the full national map (including FOIA / F-level).
-
01-state-coverage.csv
Full coverage map: facility counts, finding row counts,
ReportCoverageLevel(A/B/F), risk-KPI flags, notes. Direct proof of coverage honesty. -
02-facilities-mn-sample.csv
Facility grain: name, city, license type, ownership, capacity — matches the Facilities domain above.
-
03-findings-citations-mn-r12-sample.csv
Survey-dated findings (last 12 months): tag codes, native severity, complaint / open-like flags. No raw payloads.
-
04-tags-mn-sample.csv
Tag dictionary slice for Minnesota state tag codes.
-
05-findings-complaint-or-openlike-mn-r12-sample.csv
Complaint and/or open-like findings only — supports survey-mix and open/aging style use cases.
Also see README.txt in the sample folder. These files are samples only — licensed access covers the full available spine by tier.
Access tiers
Listed prices are starting points for commercial license + API access. Annual = two months free. No self-serve payment — request access and we follow up within one business day.
-
Explorer
$499/mo · $4,990/yr
Sample scope (1–3 states or limited facility search), delayed refresh, evaluate the spine without a full commercial pull.
- Soft limit ~60 req/min when API is provisioned
- Low daily row cap
- Internal evaluation use
-
Builder
$1,990/mo · $19,900/yr
Full available spine (A/B coverage), standard refresh, commercial analytics and product builds.
- ~300 req/min class limits
- Multi-state queries
- Commercial use (no wholesale resale without Platform+)
-
Platform
$6,500/mo · $65,000/yr
Embedding, multi-key orgs, higher limits, onboarding, and SLA language for teams shipping on the spine.
- ~1,000+ req/min class limits
- Multi-key / environment support
- Priority support & onboarding
-
Enterprise
From ~$100k/yr
National platforms, redistribution, custom export modes, DPA/BAA discussion as needed, custom SLA.
- Custom limits & contracts
- Optional bulk export programs
- Named technical contact
Pricing reflects ongoing multi-state collection, normalization, and coverage honesty — not a one-time scrape of public pages.
Measure guide
How the spine shows up in analytics: rolling R12 windows, severity and complaint mix, open-like / correction signals, coverage honesty, and where each concept lands on the Survey Risk–style board. Written in operator language — not a dump of column names.
Open ALF Survey Risk measure guide
API package (documented now, provisioned after purchase)
Full developer docs describe auth, endpoints, pagination, errors, and tier limits.
Your davvvNET Cloud base URL and API key are issued after purchase — docs use
{BASE_URL} placeholders only.
Open ALF Citations API docs Talk to us first
FOIA / pending public records
Thirteen states are F-level: facility-level findings are not bulk-public yet. We keep open FOIA / public-records paths and surface accurate status — we do not invent citation rows for these states.
| Code | State | Status |
|---|---|---|
| AK | Alaska | FOIA pending — roster/public path; findings dark |
| AR | Arkansas | FOIA pending — roster; findings dark |
| CO | Colorado | FOIA pending — aggregates public; citation grain not bulk |
| CT | Connecticut | FOIA pending — no bulk ALSA/RCH findings index |
| LA | Louisiana | FOIA pending — roster; findings dark |
| MA | Massachusetts | FOIA pending — roster/aggregates; facility findings dark |
| MD | Maryland | FOIA pending — inspect APIs empty; PIA path |
| MS | Mississippi | FOIA pending — roster; PCH findings dark |
| MT | Montana | FOIA pending — roster path; findings dark |
| NE | Nebraska | FOIA pending — CAPTCHA search; no bulk findings index |
| OH | Ohio | FOIA pending — RCF roster; facility findings dark |
| RI | Rhode Island | FOIA pending — roster; findings dark |
| SC | South Carolina | FOIA pending — CRCF findings path |
As each state opens, we load that partition and flip coverage off blackout — no national relaunch required.