# Data Dictionary - US Hospital Prices - payer-negotiated, cash & gross charges by billing code, cleaned

**Units:** stated per column in the descriptions below (this is a relational table; columns mix units).

| column | type | description |
|---|---|---|
| `hospital_id` | str | Short hospital slug (registry id) |
| `hospital_name` | str | Hospital name |
| `state` | str | US state (2-letter) |
| `payer_name` | str | Payer / insurer name (null for gross/cash-only rows) |
| `plan_name` | str | Health plan name (null where not applicable) |
| `code_type` | str | Billing code system (CPT, HCPCS, MS-DRG, APR-DRG, NDC, RC, CDM, LOCAL) |
| `code` | str | Billing code for the item/service |
| `description` | str | Item / service description |
| `setting` | str | Care setting (inpatient, outpatient, both) |
| `billing_class` | str | Billing class (facility / professional), where reported |
| `standard_charge_gross` | float | Gross charge (chargemaster / list price), USD |
| `standard_charge_discounted_cash` | float | Discounted cash price (self-pay), USD |
| `standard_charge_negotiated_dollar` | float | Payer-specific negotiated charge, USD |
| `standard_charge_min` | float | Minimum negotiated charge across payers, USD |
| `standard_charge_max` | float | Maximum negotiated charge across payers, USD |

*Source: Source hospitals' CMS Hospital Price Transparency machine-readable files (45 CFR 180); cleaned & aggregated by ReadySet - not the official unmodified files.*
