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).

~44.6kFacilities on roster
~395kFindings (all rows)
~320kFindings with survey date
~54kFindings R12
~46kCitations R12
~22kTag dictionary rows
30A-bulk states
3B-partial states
13FOIA / F-level
~38States with finding rows

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).

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
    Request Explorer
  • 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+)
    Request Builder
  • 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
    Request Platform
  • 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
    Request Enterprise

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
AKAlaskaFOIA pending — roster/public path; findings dark
ARArkansasFOIA pending — roster; findings dark
COColoradoFOIA pending — aggregates public; citation grain not bulk
CTConnecticutFOIA pending — no bulk ALSA/RCH findings index
LALouisianaFOIA pending — roster; findings dark
MAMassachusettsFOIA pending — roster/aggregates; facility findings dark
MDMarylandFOIA pending — inspect APIs empty; PIA path
MSMississippiFOIA pending — roster; PCH findings dark
MTMontanaFOIA pending — roster path; findings dark
NENebraskaFOIA pending — CAPTCHA search; no bulk findings index
OHOhioFOIA pending — RCF roster; facility findings dark
RIRhode IslandFOIA pending — roster; findings dark
SCSouth CarolinaFOIA pending — CRCF findings path

As each state opens, we load that partition and flip coverage off blackout — no national relaunch required.