CMS Medicare Dialysis Facilities Quality Data Scraper API

Search the official public CMS dialysis-facility quality dataset and receive one paid item per CCN, with repeated reporting-period measure rows aggregated into stable measures objects. Use it for provider-directory QA, dialysis market research, network analysis, quality-reporting research, and source-linked healthcare data workflows.

No CMS key, login, browser, or proxy is required.

Search and filter

• Exact CMS Certification Number (ccn), NPI, or provider name
• Bounded provider-name keyword, state, and city candidates
• Ownership type, chain, dialysis modality, and ESRD network
• Measure-name and reported measure-value text, including suppression/unavailability labels
• Deterministic sort by provider name, CCN, or qualifying measure count
• maxCandidates bounds raw CMS measure rows; maxResults caps total aggregated facility items

Exact identifiers take source-query precedence. Clear the default CCN/provider fields before a broad search. Every result discloses the candidate bound and query scope.

Fast deterministic default

{
  "ccn": "012306",
  "providerName": "CHILDRENS HOSPITAL OF ALABAMA ESRD",
  "maxCandidates": 2000,
  "maxResults": 1
}

This returns Children's Hospital of Alabama ESRD with CCN 012306, NPI and facility metadata, and non-empty source measure evidence. The maximum first-run charge is $0.0021: $0.0001 actor start plus one $0.002 facility item.

More examples

{
  "npi": "1720166085",
  "maxResults": 1
}

{
  "state": "AL",
  "city": "BIRMINGHAM",
  "modality": "Peritoneal Dialysis",
  "measureName": "COVID",
  "sortBy": "measureCount",
  "sortDirection": "desc",
  "maxCandidates": 5000,
  "maxResults": 10
}

Output

A found item includes CCN, provider name, city/state, ownership, ESRD network, NPI, chain, modality, alternate CCNs, and sorted measures. Each measure preserves the CMS name, reported value (from the current source's Measure_Score, with Measure_Value compatibility), measure ID, and reporting year. Repeated source rows do not create repeated paid facility items.

NO_MATCH and SOURCE_UNAVAILABLE are explicit stable-schema evidence items rather than silent empty datasets. A buyer charge cap is applied to the total facility count before the CMS request.

Evidence and interpretation limits

CMS rows are reporting-period quality and administrative evidence. They are not:

• real-time Medicare certification or a current enrollment determination;
• proof of current ownership, chain affiliation, address, or service availability;
• a complete clinical history, facility inspection record, or patient-level record;
• clinical advice, a provider ranking, or a provider-quality guarantee;
• proof that a blank, suppressed, unavailable, or nonnumeric measure equals zero.

Measures can use different years, populations, denominators, suppression rules, and reporting semantics. Compare only measures whose CMS definitions and reporting periods support comparison. A bounded no-match does not prove that a facility does not exist or has closed. Confirm consequential decisions with CMS and the provider.

Source

• Data API: https://data.cms.gov/data-api/v1/dataset/f8610e87-ba25-43a3-a49e-927dbc8701ae/data
• Dataset ID: f8610e87-ba25-43a3-a49e-927dbc8701ae
• Publisher: Centers for Medicare & Medicaid Services (CMS)

Pricing: $0.0001 per start + $0.002 per aggregated facility item.