GlobalMed

Price transparency

How to Read a Hospital Price Transparency File (Machine-Readable File)

Every US hospital is required to publish its standard charges in a machine-readable file. The file is public, free, and almost never readable by a human on the first try. This guide explains what is inside it and how to pull a usable cash price out of it.

By GlobalMed Editorial TeamPublished Updated 7 min read

Key points

What a machine-readable file actually is

Under the federal Hospital Price Transparency rule, hospitals must publish their standard charges in two places: a comprehensive machine-readable file containing all items and services, and a consumer-friendly display of at least 300 shoppable services. CMS states these requirements in its Hospital Price Transparency guidance and answers the definitional questions in its FAQ.

The machine-readable file is usually CSV, JSON, XML, or a ZIP archive containing one of those. It is designed to be processed by software, not read by a person. A single file can contain thousands of rows, hundreds of billing codes, and dozens of payer columns.

The four charge types inside the file

The rule requires hospitals to publish several distinct numbers for each item or service. They mean different things, and mixing them is the most common reading mistake.

  • Gross charge: the hospital's full list price before any discount. Almost nobody pays this.
  • Discounted cash price: the price for a patient paying without insurance. This is the closest number to a self-pay price.
  • Payer-specific negotiated charge: the rate agreed with a named insurer. Useful context, but not what a cash patient pays.
  • De-identified minimum and maximum: the lowest and highest negotiated rates, with the payer names removed.

Five traps that make a file misleading

Two hospitals can both comply with the rule and still be hard to compare. Watch for these.

  • Gross charge used as if it were a price. It is a starting list price, not what a patient pays.
  • Missing procedure codes. If the row has no billing code, you are relying on a text description that may not match the test you were ordered.
  • One row per code but many rows per real test. Contrast and non-contrast studies often carry different codes and very different prices.
  • Bundle versus component pricing. A facility fee, a professional fee and a contrast agent may be listed separately or folded into one line.
  • Stale files. A published file is only useful if you know when it was last updated; the file itself carries that date.

A practical reading order

If you open a hospital file yourself, work in this order: confirm the file's last-updated date, filter to the exact billing code on your order, then read only the discounted cash price column for a self-pay comparison. If you only have a description and no code, treat the number as directional until the hospital confirms it.

Keep a note of the file URL and the date you read it. That is the difference between a price you can question and a number with no provenance.

Where GlobalMed fits

GlobalMed reads hospital price transparency files, normalizes them to a single internal code, and compares them against the cost of getting the same test in China including flights, hotel and local transport. The point of the normalization is exactly the trap described above: so that a cash price is compared with a cash price.

No published price is a bill. Every figure GlobalMed shows is an estimate that the hospital confirms before you commit to anything.

Frequently asked questions

Is a hospital machine-readable file free to download?

Yes. The file must be publicly available without a login, and CMS does not charge for access. Some hospitals publish a direct link; others publish a page that links to the file.

Which number should I use if I am paying cash?

The discounted cash price is the closest published figure to what a self-paying patient pays. Gross charge is a list price and payer-specific negotiated rates belong to insured patients.

Why does my hospital file not list the test my doctor ordered?

The file may list the test under a different billing code or only under a bundled description. Ask the hospital's billing office to confirm the code and the cash price in writing.

Run the numbers

Sources and further reading

Primary sources behind the statements above. Links open the publisher's own page.

  1. Hospital Price Transparency - Centers for Medicare & Medicaid Services (CMS)

    The federal requirement that hospitals publish standard charges, including a machine-readable file and a consumer-friendly shoppable-services list.

    Last checked 2026-10-02

  2. Hospital Price Transparency Frequently Asked Questions - Centers for Medicare & Medicaid Services (CMS)

    Definitions of gross charge, discounted cash price, payer-specific negotiated charge and de-identified minimum/maximum rates.

    Last checked 2026-10-02

  3. Health Insurance Glossary - HealthCare.gov

    Plain-language definitions of allowed amount, deductible, coinsurance and other cost-sharing terms.

    Last checked 2026-10-02

Videos and official channels

Official explainer videos from the agencies and journals cited on this page.

Related reading

This article is cost and logistics analysis published by GlobalMed. It is not medical advice. Price sources are listed above; every figure shown in the comparison tool is an estimate that the hospital confirms. Canonical URL: https://accompanycn.com/articles/how-to-read-a-hospital-price-transparency-file