Simple Healthcare Search is coming soon. Get notified →
Simple Healthcare
Guide

Machine readable files, explained

Hospitals and insurers publish large datasets of healthcare payment information. Understanding their structure and limitations is the first step toward using them in a reliable comparison.

By Simple HealthcarePublished Updated

Definition. A machine-readable file is a structured dataset that software can process. Healthcare transparency files commonly use JSON or CSV to report charges, negotiated rates or allowed amounts. Hospital reporting began in January 2021, and enforcement of insurer file requirements began in July 2022. These files are an important source for commercial negotiated-rate comparisons.

Who publishes machine readable files?

Hospitals and health plans publish different files under separate federal requirements.

PublisherFile typeWhat each row containsRefresh
HospitalsStandard charges fileA billing code, the gross charge, the cash price, and the rate negotiated with each named payer and planAnnually at minimum
Insurers and applicable self-insured plansIn-network rate fileA billing code, a provider identifier, and the negotiated rate for that provider under that planMonthly
Insurers and self-insured plansOut-of-network allowed amount fileHistorical amounts the plan allowed for out-of-network claims, by provider and codeMonthly

Insurer in-network files allow employers to compare negotiated rates across payers for a given provider. Matching the right plan, service and payment terms is essential to that comparison.

Why are the files so hard to use?

The files are public, but their size and structure make them difficult to analyze. Four problems require particular attention.

  • File size. An insurer’s release can contain thousands of files and hundreds of gigabytes of data. Processing requires tools that can work through the data without loading an entire release into memory.
  • Inconsistent reporting. Publishers can represent provider groups, plan names and code modifiers differently. Analysts need to resolve those differences before comparing rates across files or reporting periods.
  • Ghost rates. A listed rate may apply to a service the provider does not perform. A peer-reviewed study of ghost rates documents this problem in Transparency in Coverage data. Those records need to be identified before calculating a usable benchmark.
  • Incomplete disclosure. Research on payer file completeness identified gaps that differed across insurers and markets. A separate comparison of four national payers documented differences in disclosure. Check the scope and date of each assessment before applying its findings to a current file.

The research page includes these studies and their methods.

How does a machine readable file become a benchmark?

Producing a benchmark requires a series of processing and validation steps. Each affects the final comparison.

  1. Ingest. Download the relevant releases, retain their source dates and normalize the file structure.
  2. Clean. Check for invalid codes, placeholder values and outliers. Use utilization information to help identify provider-service combinations that represent ghost rates.
  3. Enrich. Add provider affiliations, facility types and geography. Attach quality information where it is available and relevant to the comparison.
  4. Validate. Compare results with prior releases and relevant claims sources. Investigate whether a rate change reflects a contract change or a reporting difference, and label estimated values.
  5. Assemble. For episode comparisons, connect the relevant facility and professional services using consistent episode definitions and provider affiliations.

Different analysts can produce different benchmarks from the same files because they make different choices at these stages. Ask how providers were matched, how invalid rates were handled and which services were included.

What can you do with machine readable file data?

The same underlying rates support several types of analysis.

  • Employers compare plan payments with other negotiated rates and assess potential changes in purchasing arrangements.
  • Advisors and consultants use rate comparisons to evaluate renewal terms, network proposals and provider contracts.
  • Payers and TPAs compare their network rates with those reported elsewhere in the market.
  • Product teams use negotiated rates in navigation, provider selection and contracting tools.
  • Researchers study payment variation and provider markets, subject to the data’s coverage and limitations.

What is inside a Transparency in Coverage file?

The insurer in-network file uses a schema published by CMS. The fields below explain how a rate is connected to a plan, provider and service.

FieldWhat it holdsWhy it matters
Reporting entity and planThe insurer and the specific plan the rates apply toIdentify the specific plan or network before using the rate in a comparison
Billing code and typeA CPT, HCPCS, DRG or other code, with its code systemCodes are the unit of pricing; episodes have to be assembled from them
Provider groupNational Provider Identifiers and tax identifiers for the providers the rate applies toTies a rate to a real provider, and to the affiliation data that groups providers into systems
Negotiated typeWhether the rate is a negotiated amount, a derived value, a fee schedule, a percentage of charges, or a per diemInterpret the payment type before treating the value as a dollar amount; some records require additional information
Negotiated rateThe dollar amount, or the percentage or multiplierRead with the payment type, provider and service fields to establish what the value means
Billing class and service codeProfessional versus institutional, and the place-of-service codeThe same procedure code carries different rates in a hospital and an office
Expiration dateWhen the rate stops applyingSeparates a live contract from a stale one

Two features require particular care. First, a reported provider group can include many identifiers, even when only some providers perform a given service. This can create ghost rates. Second, the payment type may describe a percentage or another arrangement that cannot be compared directly with a fixed dollar rate.

Hospital files describe rates from the hospital’s perspective, listing its standard charges and payer-specific negotiated charges. Where hospital and insurer records overlap, comparing them can help identify matching or reporting problems.

How Simple Healthcare helps

We process transparency files to identify ghost rates, flag estimates and retain the source and date of each rate. Analysts access the resulting tables through Landscape, and product teams can use data and licensing. Employers use the rates in Roadmap alongside their own claims. Our published methodology explains the processing choices behind those comparisons.

Find out what your market pays.

Compare published carrier rates in your metro. Start with your location and carrier; a claims-based plan analysis can follow if useful.

FAQ

Frequently asked questions.

Is "machine readable file" the same as "machine-readable file" or MRF?

Yes. These terms are used for the same type of structured file. MRF is the abbreviation. In healthcare transparency, the contents and reporting requirements depend on whether the publisher is a hospital or a health plan.

Can I download the files myself?

Yes. Hospitals and insurers publish their files online. Many insurer releases require software capable of processing large datasets, along with checks for provider matching, payment types and invalid records.

Do the files show what a patient will pay?

A negotiated rate alone does not establish a patient’s bill. The amount owed also depends on the services received, coverage, deductible and cost sharing. Simple Healthcare Search, our consumer-facing tool, is coming soon.

Are hospital files and insurer files consistent with each other?

The records can differ because of reporting dates, code modifiers, payment types or provider matching. Investigate those differences before treating the two records as equivalent observations of a contract.