Healthcare / home-health agency reference / DOCUMENTED CSV

Home Health Agency & Quality Reference

Find agencies that have served a postal ZIP and add services, quality measures and patient experience to a research list. Prepared tables keep source periods, missing values and CMS qualifications alongside the results.

CMS release July 15, 2026 · survey year 2025 · quality periods vary · fixed edition

12,460home-health agency records

22main-table fields

565,608agency / served-ZIP relationships

34,842distinct served postal ZIP codes

01 / KNOW THE FIT

A useful join starts
with a clear meaning.

What you can do with it

Start with a ZIP-code market list or CMS agency identifiers. Identify historical service relationships, inspect reported services, and compare the same quality or survey measure across agencies. Useful for healthcare market research, provider-network analysis and consulting.

What one row means

agencies.csv has one row per CMS Certification Number (CCN). served_zips.csv has one row per agency and served ZIP. quality_measures.csv and patient_experience.csv have one row per agency and measure, including unavailable observations.

Unique key
agency_id

How to join it

Import CCNs and ZIPs as text. Join served_zips.csv to your postal ZIP list, then agencies.csv on agency_id. Multiple agency matches are expected. Filter measure_id before adding a long measure table. The office ZIP is different from served ZIPs; neither is a Census ZCTA or county FIPS.

Find home-health agencies by ZIP in Python →

Coverage, with the edges visible

All 12,460 agencies in the retained CMS file, with matching survey and ZIP-reference agency universes. Includes all 565,608 agency/ZIP pairs, 18 quality measures and 12 survey measures per agency. All 590,551 rows across five source CSVs are accounted for without dropping or deduplicating records. Covers 50 states, DC and the source territories PR, GU, MP and VI.

Keep in mind

ZIP relationships describe areas where an agency served at least one patient during the source collection period. Exact ZIP-table dates are not supplied. They do not guarantee current service territory, current availability, or patient volume.
Services are agency-level flags, not ZIP-specific services. Source dashes remain unavailable, not No. This is a dated source universe, not an independently verified active-agency list.
Quality stars and patient-survey stars are separate measures. Survey results nominally cover 2025; notes can qualify the period or response count. Quality and claims periods vary. These data are not individual care recommendations.
Risk-adjusted rates need not equal raw numerator divided by denominator. In 129 discharge-to-community records, a published value or bound exceeds 100; these are preserved with a flag, not clipped. Spending is a ratio to a national benchmark, not dollars.
No patient records, current availability, NPI/county-FIPS crosswalk, geographic allocation weights, HHVBP payment-performance data or state/national aggregate benchmark tables are included.

WHAT MAKES IT ACTUALLY CLEAN

Preserves source identifiers, every agency and every ZIP relationship. Separates 18 care-quality measures from 12 patient-survey measures, maps reporting periods, retains counts and bounds, resolves survey footnotes and distinguishes missing numbers from zero. Source dashes in service flags remain explicit. Independent acceptance checks original CSV cells and dictionary text; retained raw, staging and preparation recipes reproduce offline. How we prepare and version our data →

02 / TRY THE SHAPE

Real rows. Before you buy.

These are the first three rows from the delivered CSV, showing 6 of 22 fields. The free download contains the first five rows and all 22 fields; it is a format sample, not a coverage test.

Home Health Agency & Quality Reference · first three rows
agency_id	agency_name	state	quality_stars	survey_stars	served_zip_count
027001	PROVIDENCE AT HOME WITH COMPASSUS HH ANCHORAGE	AK	3.5	3	16
027002	HOSPICE & HOME CARE OF JUNEAU	AK			1
027006	FAIRBANKS MEMORIAL HOSPITAL HHA	AK	3		5

03 / NO GUESSING

Main table fields, explained.

The main table’s field dictionary from the current download. CSV has no built-in types; these are the intended import types.

All 22 fields in CSV order
Field	Type	Meaning
`state`	string	Original CMS State. Source dash (-) means not available; it is retained, never changed to No.
`agency_id`	string	Six-character CMS Certification Number, text with leading zeros; not an NPI.
`agency_name`	string	Original CMS Provider Name. Source dash (-) means not available; it is retained, never changed to No.
`address`	string	Original CMS Address. Source dash (-) means not available; it is retained, never changed to No.
`city`	string	Original CMS City/Town. Source dash (-) means not available; it is retained, never changed to No.
`zip_code`	string	Office postal ZIP, not a service territory, Census ZCTA or county FIPS.
`telephone`	string	Original CMS Telephone Number. Source dash (-) means not available; it is retained, never changed to No.
`ownership_type`	string	Original CMS Type of Ownership. Source dash (-) means not available; it is retained, never changed to No.
`offers_nursing`	string	Original CMS Offers Nursing Care Services. Source dash (-) means not available; it is retained, never changed to No.
`offers_physical_therapy`	string	Original CMS Offers Physical Therapy Services. Source dash (-) means not available; it is retained, never changed to No.
`offers_occupational_therapy`	string	Original CMS Offers Occupational Therapy Services. Source dash (-) means not available; it is retained, never changed to No.
`offers_speech_pathology`	string	Original CMS Offers Speech Pathology Services. Source dash (-) means not available; it is retained, never changed to No.
`offers_medical_social`	string	Original CMS Offers Medical Social Services. Source dash (-) means not available; it is retained, never changed to No.
`offers_home_health_aide`	string	Original CMS Offers Home Health Aide Services. Source dash (-) means not available; it is retained, never changed to No.
`certification_date`	string	ISO certification date, blank if source dash; source value retained separately.
`source_certification_date`	string	Original CMS date cell; dash means not available.
`quality_stars`	number	Published quality-of-patient-care stars, 1–5 in half-star steps; blank when unavailable. Multiple component periods.
`quality_stars_status`	string	published or not_available; original value and footnote in quality_measures.csv.
`survey_stars`	number	Separate HHCAHPS patient-experience summary rating, 1–5 whole stars; blank when unavailable.
`survey_stars_status`	string	published or not_available; read patient_experience.csv for footnotes and period.
`served_zip_count`	integer	Count of distinct ZIP relationships in this edition; not current availability, patient volume or market share.
`source_row`	integer	One-based data row in original providers.csv.

04 / INSIDE THE DOWNLOAD

Data, with its context.

One ZIP · 9.3 MB · 21 files. No account or subscription required.

README.mdImport guidance, method, attribution, and limitations
acceptance.jsonIndependent original-source checks
agencies.csvMain prepared table · UTF-8 CSV
all_tables_dictionary.jsonField definitions for all eight tables
checksums.jsonSHA-256 checksums for the release files
collection_periods.csvAll 23 original quality and survey period definitions
data_dictionary.jsonTypes and definitions for every field
example.pyNotebook-compatible lookup from ZIPs to agencies, services and ratings
example_input.csvFictional research labels with real postal ZIPs
example_output.txtChecked printed example output
example_result.csvChecked lookup results
footnotes.csv13 CMS dictionary footnotes; excludes HHVBP-only definitions
measures.csv30 measure definitions and explicit original-column mappings
metadata.jsonSource provenance, production time, counts, and CSV checksum
patient_experience.csv149,520 observations: 12 separate HHCAHPS measures per agency, periods and resolved survey footnotes
provenance.jsonRetained source identifiers, URLs and file checksums
quality_measures.csv224,280 observations: 18 care-quality measures per agency, with source values, periods, counts, bounds and notes
quality_report.jsonCoverage, missingness and product-specific quality checks
revision.jsonChanges and free-upgrade eligibility for this ACD revision
served_zips.csv565,608 agency-to-ZIP relationships; reported historical service, not guaranteed availability
source_row_status.csvOutcome for every row in all five source CSVs

05 / DATES THAT MEAN SOMETHING

Sources, versions & changes.

Source versions identify the inputs. Our processing revision describes how we prepare them. Either kind of change creates a new ACD release; the package date records when it was built.

Current source versions

CMS source release: July 15, 2026 · all five datasets
CMS metadata modified: May 27, 2026 for agency/ZIP/quality periods; June 10 for survey files
OASIS quality period: October 1, 2024–September 30, 2025
Patient survey period: January 1–December 31, 2025, subject to agency footnotes
Claims / spending periods: DTC and spending: 2023–2024; readmission: 2022–2024; hospitalization: 2024
ZIP relationship period: Exact dates not specified in retained sources
ACD capture / preparation: October 18, 2026 UTC · processing revision 1
Package prepared (UTC): Oct 18, 2026

Source: Centers for Medicare & Medicaid Services. Original government data are freely available. ACD sells preparation, validation, documentation and delivery. Independent preparation; no CMS endorsement.

RELEASE HISTORY

Oct 18, 2026 · current package (UTC)

First ACD edition of these retained inputs: agency reference, served ZIP relationships, care quality, patient experience, measure definitions, collection periods, footnotes and full source-row accounting. Includes dictionaries, provenance, independent acceptance and a checked Python example. No prior-edition comparison is claimed.

Home-health reference: source and preparation record

Processing corrections and improvements for your purchased source edition are free. Genuinely new source editions may be sold separately. See the update policy and access instructions.

Check the downloaded CSV’s integrity

The metadata file inside the ZIP records this SHA-256 checksum for agencies.csv. A matching checksum confirms identical CSV bytes.

dee39bf2a446a30ab0b22ac3168b860a891668a2c89b5546cb2747468d842d0b

READY TO PUT IT TO WORK?