Stoploss Provisions
A stoploss provision is a contract clause that changes how a payer reimburses a claim once it crosses a threshold. These are not inherently reported in price transparency data, but are often described in hospital additional notes. Remits analyses can also help triangulate high dollar reimbursement trends.
Strategy
Stoploss terms are sparsely and inconsistently documented, so the pipeline is designed to maximize coverage while preserving confidence.
Step 1 — Collect direct observations. Hospital price transparency files (MRF) are parsed for notes that describe stoploss terms and aggregated to one row per provider-payer-network. Claims remittance data (Komodo) is processed in parallel to identify providers whose large claims are consistently paid at a stoploss-level percentage, aggregated to one row per provider-payer.
Step 2 — Build the universe. Every provider-payer-network combination that could plausibly have a stoploss clause is enumerated into a single table. This becomes the target — every row in this universe will receive a stoploss rate.
Step 3 — Fill gaps through progressive inference. Not every provider-payer-network has direct evidence. The pipeline applies nine inference methods in descending confidence order: first broadcasting a provider's own observed terms across their other networks, then borrowing from health system peers, then aggregating across similar contracts in the same network and state, and finally falling back to national patterns. Each method assigns a confidence score (0–10); the highest-scoring row wins per contract group.
Step 4 — Combine. All sources are unioned and deduplicated, keeping the best row per contract group.
Classification
Every stoploss provision is described by these fields:
| Field | Values | Description |
|---|---|---|
stoploss_type | first dollar, second dollar | Whether the rate applies to the entire claim or only the excess above the threshold |
threshold_type | dollar, LOS, none | What triggers the provision — a dollar amount or a length-of-stay (days) |
threshold_value | DOUBLE | Dollar amount (e.g., 100000) or day count (e.g., 5) |
reimbursement_type | percentage, per diem | Rate structure once the threshold is crossed |
reimbursement_value | DOUBLE | Percentage (e.g., 75) or per diem amount (e.g., 1500) |
nte_type | dollars per day, NULL | Cap type, when present |
nte_value | DOUBLE | Cap amount per day, when present |
Confidence Score
Every row in the combined table has a canonical_score (0–10). When multiple sources cover the same contract group, the highest-scoring row wins.
| Score | canonical_source | Description |
|---|---|---|
| 10 | mrf_full | Direct MRF extraction — both stoploss_type and at least one rate field successfully parsed |
| 9 | mrf_note_only | MRF extraction with a qualifying note, but stoploss_type could not be classified |
| 8 | mrf_cross_network | Provider's own MRF data applied to all their networks with the same payer |
| 7 | remits | Provider's dominant claims payment pattern applied to all their networks |
| 6 | health_system | Terms inherited from a peer hospital in the same health system |
| 5 | health_system_cross_network | Health-system-inherited terms applied to all networks for that provider-payer |
| 4 | network | Most common structure among ≥5 providers in the same payer, network, and state |
| 3 | payer_network_state_agg | Most common structure across all providers in the same payer, network, and state |
| 2 | payer_network_national_agg | Same as Score 3, applied nationally across the same payer and network |
| 1 | state_agg | Most common structure across all providers in the same state |
| 0 | national_agg | Universal fallback — always present for every row in the universe |
Architecture
SOURCE SYSTEMS
├─ Hospital Rates (MRF) glue.hospital_data.hospital_rates
└─ Claims Remits (Komodo) tq_intermediate.external_komodo.remits
↓
① OBSERVATION
MRF Path
├─ provisions_stoploss_mrf_base
├─ provisions_stoploss_mrf_extracted
└─ provisions_stoploss_mrf_aggregated scores 9–10
Remits Path
├─ provisions_stoploss_remits_base
└─ provisions_stoploss_remits_aggregated
↓
② PROVIDER UNIVERSE
└─ provisions_stoploss_provider_universe all provider × payer × network
↓
③ INFERENCE
├─ provisions_stoploss_mrf_crossnet_broadcast · 8
├─ provisions_stoploss_remits_broadcast · 7
├─ provisions_stoploss_healthsystem · 6
├─ provisions_stoploss_hs_crossnet_broadcast · 5
├─ provisions_stoploss_network · 4
├─ provisions_stoploss_agg_payer_net_state · 3
├─ provisions_stoploss_agg_payer_net_national · 2
├─ provisions_stoploss_agg_state · 1
└─ provisions_stoploss_agg_national · 0
↓
④ COMBINED
└─ provisions_stoploss_combined best score wins per group
Layer 1: Observation
MRF Notes
Hospital price transparency notes are processed in three steps to produce structured stoploss terms for each provider, payer, and network combination.
Step 1 — Base (provisions_stoploss_mrf_base)
Pulls all commercial hospital rate records whose notes mention stoploss-related terms and contain dollar amounts.
Filter criteria
- At least one note field (
additional_generic_notes,additional_payer_notes,negotiated_algorithm) contains any of:stop,loss,threshold,discount,charges,outlier - At least one note field contains a digit
payer_class_name = 'Commercial'- Network ID is not null, or
plan_nameis not null
Step 2 — Extracted (provisions_stoploss_mrf_extracted)
Filters out non-stoploss notes, then parses each qualifying note into structured fields: stoploss type, threshold, reimbursement rate, and cap.
Filtering and extraction detail
Multi-field exclusions
Notes matching any of these patterns — based on combinations of note fields — are dropped before extraction:
| Pattern | Condition |
|---|---|
| Hospital System Supply Identifier | Generic note contains "Hospital System Supply Identifier" ending with "Lawson ID", no payer notes |
| Term Line | Generic note ends with "Term Line" + number, no payer notes |
| Outpatient billing | Generic note is exactly the standard outpatient billing setting note, no payer notes |
| Re-evaluated | Payer or generic note starts with "Re-evaluated:", no "threshold" keyword |
| CPT + contract payment | Generic note is a CPT code; payer note starts with "contract indicates payment" |
| Bare number + % of charges | Generic note is a bare number; payer note is exactly "N% OF TOTAL BILLED CHARGES" |
| Rev/Proc code | Generic note matches "Rev NNN Proc NNNNN" format, no payer notes |
| Reimb exceeds charges | Generic note is exactly "Reimb exceeds charges. Trim to Lessor Of Claim" |
| OPPS APC | Any note starts with "OPPS" + whitespace/; + "APC" |
Per-note exclusions — 10 families of note text that indicate non-stoploss content
Notes containing any of the following patterns are excluded on a per-note basis:
Carveouts
Cost Plus Markup- Starts with
Implants and Devices - Contains
implant threshold implants on a single charge line- Starts with
If > $2500 - Starts with
Eligible charges greater than $1,090 - Contains
at cost + - Contains
documented acquisition cost - Contains
invoice cost
Revenue-code-specific thresholds
- Contains
qualifying revenue code - Contains
applicable revenue code charges exceed - Contains
revenue code charges exceed - Contains
threshold for each revenue code - Contains
charges for specified revenue codes exceed - Matches
(rev code NNN) charges in excess of - Matches
Rev 0NNN ... in addition to IP rate - Contains
revenue code charges included in per diem
Transplant / global case rates
- Starts with
Global case rate listed refers to the fixed fee payment made to provider... - Starts with
Patients who expire during treatment or who do not complete the transplant process - Contains
transplant case rate includes/refers to/is inclusive - Contains
transplant global case rate - Contains
transplant inlier case rate/period - Contains
transplant inpatient stays exceeding - Contains
case rate applies to the mother's stay - Contains
highest case rate is paid - Contains
packaged/bundled into a separate rate
Fee schedules / OPPS / Medicare
- Starts with
APC grouping requires price history - Starts with
Paid under OPPS; - Contains
OPPS CCR - Contains
MEDICARE OPPS OUTLIER - Starts with
This is being calculated using the IPPS logic from CMS. - Matches
Medicare NNN/NNN Reimbursement: - Starts with
Medicare OP Reimbursement: - Starts with
TRICARE OP Reimbursement: - Contains
contractual percentage of Medicare - Starts with
MEDICAL/SURGICAL Procedures: Fee Schedules - Contains
to determine the federal payment amount for each IRF patient
Code-level / lookup rates
- Matches
DRG NNN DRG Case Weight - Contains
of billable gross charges for specified code - Contains
aggregated billable gross charges for specific code - Starts with
Procedure Lookup Tables: - Starts with
(Sum: ) Procedure Lookup: - Starts with
FormulaCPE: - Starts with
Group (Sum Of) - Starts with
Group (Lesser Of) - Contains
primary procedure pays at
Long-stay / outlier structures
- Contains
Long Stay Outlier - Starts with
High Cost Outlier: - Contains
Capital Addon - Starts with
Admin Days: - Contains
outlier payments are provided on a service basis - Contains
outlier terms do not apply - Contains
adjusted base rate indicated...further adjusted for transfers and outliers - Contains
additional reimbursement may apply if total charges exceed threshold - Matches
lesser of: [(if transferred
Non-stoploss rate structures
- Matches
N% of cost - Contains
reimbursed at ... of invoice cost when billed charges exceed - Contains
reimbursement rate exceeds billed charges - Contains
uncontracted outpatient services will be paid - Contains
services not specifically listed in contract
Specialty / clinical billing
- Contains
anesthesia is calculated by adding together base units - Contains
anesthesia procedures will divide billed minutes - Contains
midlevel providers and midlevel modifiers are paid - Contains
skilled nursing provision - Contains
use this provider number in place of provider number from claim
Algorithm notes / scripting artifacts
- Starts with
Interim Value: - Starts with
Can be subject to stoploss provisions - Starts with
Re-evaluated: HLB.(without threshold keyword) - Contains
End If - Contains
Processing Action: Note Only - Matches
{Charges In Service Type}or{Units In Service Type}(unfilled template variable)
Carveout exclusion format
- Contains
\nExclusion -withoutRate Threshold
Extraction patterns — regex and keyword rules for parsing thresholds, rates, and caps from raw note text
Text is normalized before extraction: lowercased, hyphens removed, % → "percent".
Stoploss Type (first match wins):
| Priority | Value | Signal |
|---|---|---|
| 1 | first dollar | first dollar, 1st dollar, entire claim, entire admission, entire stay |
| 2 | second dollar | second dollar, 2nd dollar, in addition to, over the threshold, charges over, charges in excess, after the threshold, above the threshold, for each day past, days after, excess of, over and above (with carveout-language guards) |
| 3 | first dollar | charges exceeding followed by threshold or outlier |
| 4 | first dollar | Note contains revert (with guards) |
| 5 | first dollar | Note starts with charges greater than |
Dollar Threshold:
| Pattern | Example |
|---|---|
| k-notation | $50k, 1.5k |
Keyword-anchored (exceeds, threshold of, greater than + ≥5-digit number) | exceeds $100,000 |
Structured fixed amount (+ Fixed Amount N) | + Fixed Amount 56687.00 |
| Numeric fallback (any ≥5-digit number) | $25000 |
LOS Threshold: trigger word (exceeds, >, past, after, etc.) + number + day(s) — e.g., exceeds 5 days
Reimbursement — Percentage:
| Pattern | Example |
|---|---|
Structured reimbursement rate (Stoploss First/Second Dollar + Reimbursement Rate N) | Stoploss First Dollar + Reimbursement Rate 60.00 |
Structured POC rate (initial rate is zero, followed by + Percent Of Charge + Reimbursement Rate N) | + Percent Of Charge + Reimbursement Rate 54.25 |
Structured rate threshold (percentage on same line as Rate Threshold in auto-generated note) | Rate Threshold $125,000.00...reimbursed at 18.6% |
Decimal (N.N percent) | 60.5% |
Integer (N percent) | 75% |
Reimbursement — Per Diem:
| Pattern | Example |
|---|---|
Amount-before (N per diem) | 1500 per diem |
Rate-of (per diem rate of N) | per diem rate of $1500 |
Bare (per diem N) | per diem $1500 |
Cap: not to exceed / NTE / up to a maximum of + number + (optional k) + per day
Quality gate and confidence scoring
A note is only kept if:
- Contains
stoploss,threshold,excess,outlier, orexceed— or starts withcharges greater than - At least one field extracted: percentage, per diem reimbursement, dollar threshold ≥ $50K, or per diem threshold
Confidence score (sum of all fired pattern weights, max 15):
| Category | Pattern | Points |
|---|---|---|
| Stoploss Type | stoploss_type is not null | 1 |
| Dollar Threshold | k-notation, keyword-anchored, or structured | 2 |
| Dollar Threshold | numeric-fallback | 1 |
| Dollar Threshold | value between 300K (bonus) | 1 |
| LOS Threshold | days-keyword | 1 |
| LOS Threshold | value between 3–30 days (bonus) | 1 |
| Percentage | structured auto-generated format | 3 |
| Percentage | decimal or integer | 2 |
| Percentage | value between 20%–70% (bonus) | 1 |
| Per Diem | amount-before or rate-of | 2 |
| Per Diem | bare | 1 |
| Per Diem | value between 5,000 (bonus) | 1 |
| Cap | either pattern | 2 |
Step 3 — Aggregated (provisions_stoploss_mrf_aggregated)
Produces one row per provider-payer-network. When multiple qualifying notes exist for the same group, the best is selected — preferring notes shared by more rate IDs and notes with more extracted fields.
Rows where both the threshold and reimbursement type are fully classified get source_label = 'mrf_full' (score 10). Rows where the note qualifies but the stoploss type could not be determined get source_label = 'mrf_note_only' (score 9).
Output schema
| Column | Type | Description |
|---|---|---|
mrf_id | VARCHAR | provider_id-payer_id-network_id-setting |
provider_id | VARCHAR | |
payer_id | VARCHAR | |
network_id | BIGINT | |
setting | VARCHAR | 'Inpatient' or 'Outpatient' |
source_label | VARCHAR | 'mrf_full' or 'mrf_note_only' |
stoploss_type | VARCHAR | 'first dollar', 'second dollar', or NULL |
threshold_type | VARCHAR | 'dollar', 'LOS', or NULL |
threshold_value | DOUBLE | Dollar amount or day count |
reimbursement_type | VARCHAR | 'percentage', 'per diem', or NULL |
reimbursement_value | DOUBLE | Percentage or per diem dollar amount |
nte_type | VARCHAR | 'dollars per day' or NULL |
nte_value | DOUBLE | Cap amount per day |
dollar_threshold | DOUBLE | Raw extracted dollar threshold |
per_diem_threshold | DOUBLE | Raw extracted day count threshold |
percentage_reimbursement | DOUBLE | Raw extracted percentage |
per_diem_reimbursement | DOUBLE | Raw extracted per diem amount |
ref_matched_text | VARCHAR | Pipe-delimited substrings that matched |
ref_regex_pattern | VARCHAR | Pipe-delimited pattern labels |
ref_rate_count | BIGINT | Distinct rate IDs sharing the canonical note |
source_id | BIGINT | Minimum rate ID from the contributing group |
source_note | VARCHAR | Note text used for extraction |
traceability | VARCHAR | JSON with source record ID, note type, rate count, note text |
Remits
Claims remittance data from Komodo is used to infer stoploss reimbursement rates where MRF notes are unavailable.
Step 1 — Pre-Processing (remits_lines_by_year)
Raw claims are filtered, linked to hospital and payer reference data, and grouped by year to produce the input for the clustering step.
Pipeline steps
| Step | Table | Description |
|---|---|---|
| 1 | remits_spines | Join remits to hospital and payer spines in a single pass |
| 2 | remits_stoploss_rollup | Roll up stoploss provisions to (provider, payer) level |
| 3 | remits_header | Aggregate to remit_id grain; threshold driven by MRF with $150K fallback |
| 4 | remits_lines | Line-level table scoped to remit_ids in header, with applied_threshold per line |
| 5 | remits_lines_filtered | Filter to quality gates and 10–90% payment ratio for stoploss signal |
| 6 | remits_lines_by_year | Group filtered lines by year — final output consumed by remits_base |
Input tables: tq_intermediate.external_komodo.remits, tq_intermediate.external_komodo.medical_headers, tq_production.spines.spines_provider_hospitals, and payer mapping tables.
Step 2 — Base (provisions_stoploss_remits_base)
Groups payment rates from claims history into clusters to identify the dominant rate for each provider-payer pair, giving extra weight to surgical claims.
Clustering algorithm
- Input range: Lines with
line_perc_allowedbetween 0.25 and 0.95 (25%–95%) - Revenue code weighting: Surgical codes (
revenue_codenot in 025x, 026x, 027x, 063x, 064x) are weighted 3x - Clustering: Rates sorted ascending; a new cluster starts when
gap > 0.05(5 percentage points). Each cluster is labeled by its minimum rate value - Cross-year aggregation: Clusters scored by
n_years,n_rev_codes,n_surgical_codes,lines_at_percentage, andlines_at_percentage_weighted
Step 3 — Aggregated (provisions_stoploss_remits_aggregated)
Selects the dominant payment rate cluster per provider-payer. The winning cluster must have at least 25 claims and represent more than 25% of total lines. If no MRF threshold is available, $150,000 is used as the fallback.
Traceability fields
| Field | Description |
|---|---|
ref_lines_at_pct | Number of lines at the dominant rate |
ref_pct_of_total | Dominant rate's share of all lines for this provider-payer |
ref_total_lines | Total lines across all clusters |
ref_stoploss_threshold | Applied threshold (from MRF or $150K default) |
ref_threshold_source | 'mrf' or 'default' |
ref_rate_distribution | JSON map of all rate clusters and their line counts |
Layer 2: Provider Universe
Defines every provider-payer-network combination that will receive a stoploss row. All inference methods in Layer 3 fill values into this universe.
Built from three sources — commercial rate records, MRF-observed stoploss rows, and remits-observed rows — then enriched with provider and payer attributes.
Source tables and enrichment columns
Sources (deduplicated, clear_rates preferred over mrf when both present):
| Source | Description |
|---|---|
clear_rates | All hospital commercial rate records with canonical_rate_score > 1 and a non-null network_id |
mrf | All rows from provisions_stoploss_mrf_aggregated |
remits | All rows from provisions_stoploss_remits_aggregated (null network_id; pass through as-is) |
Enrichment joins:
- Provider attributes (health system, location, bed count, revenue) from
spines_provider_hospitals+spines_provider_healthsystems - Payer commercial market share by state from
policy_reporter_state
Hospital attributes
| Column | Description |
|---|---|
healthsystem_id, healthsystem_name | Health system affiliation |
provider_state, provider_city, provider_county | Location |
provider_latitude, provider_longitude | Coordinates |
provider_type, provider_subtype | Provider classification |
total_licensed_beds | Hospital size |
net_patient_revenue | Hospital revenue |
national_net_patient_revenue_rank | NPR rank nationally (RANK() OVER ORDER BY net_patient_revenue DESC) |
state_net_patient_revenue_rank | NPR rank within state |
Payer coverage data
| Column | Description |
|---|---|
payer_state_covered_lives | Payer's covered lives in the provider's state |
payer_state_covered_lives_pct_of_total | Payer's share of total commercial covered lives in that state |
Layer 3: Inference
Methods are listed in confidence order (highest score first). The highest-scoring row per contract group wins.
Some methods adjust dollar thresholds using each hospital's cost-to-charge ratio (CCR), so that thresholds are comparable across hospitals with different charge structures.
CCR adjustment formula
adjusted_threshold = ROUND(source_median_threshold × recipient_ip_ccr_relativity, 0)
The source threshold is first normalized by the source hospital's CCR relativity, then scaled by the recipient hospital's CCR relativity. If a relativity is outside [0.1, 10.0] or unavailable, the raw median is used instead.
Broadcasts
Take a single observed rate per provider-payer and apply it to all networks for that pair — no aggregation or inference, just expansion of what's already known.
Score 8 — MRF Crossnet Broadcast (provisions_stoploss_mrf_crossnet_broadcast)
Extends a provider's own MRF stoploss terms to all their networks with the same payer. For example, if BCBS Preferred has data, those terms are applied to BCBS Select and BCBS HMO where no direct data exists.
Source: MRF — provider's own stoploss data, best row per provider-payer
Recipients: All networks for that provider-payer pair
Expanded to: (provider, payer) → (provider, payer, network)
Selection logic
- From
provisions_stoploss_mrf_aggregated, select the best row per (provider, payer): prefersource_label = 'mrf_full'(score 10) over'mrf_note_only'(score 9); tiebreak bydollar_threshold DESC NULLS LAST - Join to the provider universe on (provider, payer) — one source row fans out to all networks for that provider-payer
- Provider's own observed network is included (no self-exclusion)
Traceability fields
| Field | Description |
|---|---|
source_network_id, source_network_name | The specific network the source MRF row came from |
source_label | 'mrf_full' or 'mrf_note_only' |
source_note | Original MRF note text used for extraction |
Score 7 — Remits Broadcast (provisions_stoploss_remits_broadcast)
Extends the payment rate inferred from claims history to all networks for that provider-payer pair.
Source: Remits — provider's dominant payment rate cluster, best per provider-payer
Recipients: All networks for that provider-payer pair
Expanded to: (provider, payer) → (provider, payer, network)
Selection logic
- From
provisions_stoploss_remits_aggregated, select one row per (provider, payer) — the dominant cluster already chosen in Layer 1 - Join to the provider universe on (provider, payer) — fans out to all networks
- No stoploss type or threshold type is assigned; only
reimbursement_type = 'percentage'andreimbursement_valueare set from the cluster rate
Traceability fields
| Field | Description |
|---|---|
ref_lines_at_pct | Number of claims lines at the dominant rate cluster |
ref_pct_of_total | Dominant cluster's share of all lines for this provider-payer |
ref_total_lines | Total lines across all clusters |
ref_stoploss_threshold | Dollar threshold used to identify stoploss claims (from MRF or $150K default) |
ref_threshold_source | 'mrf' or 'default' |
ref_rate_distribution | JSON map of all rate clusters and their line counts |
Health System
Borrow stoploss terms from a peer hospital in the same health system that has direct MRF data.
Score 6 — Health System (provisions_stoploss_healthsystem)
Copies stoploss terms from a peer hospital in the same health system that has price transparency data. The peer with the highest dollar threshold is used as the representative. Terms are copied directly with no adjustment.
Source: MRF (Health System) — stoploss data from a peer hospital in the same health system
Recipients: All hospitals in that health system without their own MRF data for that payer and network
Expanded to: (health system, payer, network) → (provider, payer, network)
Selection logic
- For each (healthsystem, payer, network), find all MRF rows where
source_note IS NOT NULLand the provider has ahealthsystem_id - Rank by
dollar_threshold DESC NULLS LAST,percentage_reimbursement DESC NULLS LAST— select the highest-threshold row as the representative - All other providers in the same healthsystem receive that representative's stoploss terms for the same (payer, network)
- Source provider is excluded from receiving its own terms (
provider_id <> source_provider_id)
All stoploss fields are copied directly from the representative MRF row.
Traceability fields
| Field | Description |
|---|---|
source_hs_id, source_hs_name | Health system the source provider belongs to |
source_provider_id, source_provider_name | The specific provider whose MRF data was inherited |
source_network_id, source_network_name | Network of the source row |
source_payer_id, source_payer_name | Payer of the source row |
source_note | Original MRF note text |
Score 5 — Healthsystem Crossnet Broadcast (provisions_stoploss_hs_crossnet_broadcast)
Takes the stoploss terms inherited from a health system peer (Score 6) and applies them across all networks for that provider-payer pair, using the same logic as Score 8.
Source: MRF (Health System) — health-system-inherited stoploss data, best row per provider-payer
Recipients: All networks for that provider-payer pair
Expanded to: (provider, payer) → (provider, payer, network)
Selection logic
- From
provisions_stoploss_healthsystem, select the best row per (provider, payer): tiebreak bydollar_threshold DESC NULLS LAST - Join to the provider universe on (provider, payer) — fans out to all networks
- Mirror of Score 8 logic, but sourced from health-system-inherited data rather than direct MRF data
Traceability fields
| Field | Description |
|---|---|
source_hs_id, source_hs_name | Health system the original source provider belongs to |
source_provider_id, source_provider_name | The peer hospital whose MRF data was inherited in Score 6 |
source_network_id, source_network_name | Network of the Score 6 source row |
source_payer_id, source_payer_name | Payer of the Score 6 source row |
source_note | Original MRF note text |
Network
Infer stoploss terms from the most common structure seen across providers in the same payer, network, and state — with a high-confidence bar.
Score 4 — Network Inference (provisions_stoploss_network)
Infers stoploss terms from the most common structure seen among providers in the same network and state. Requires at least 5 providers with 80% agreement on the dominant structure. Dollar thresholds are adjusted for each hospital's charge structure.
Source: MRF — ≥5 providers in the same payer, network, and state with ≥80% agreement on structure
Recipients: All providers in that payer, network, and state
Expanded to: (payer, network, state) → (provider, payer, network)
Eligibility and calculation
Eligibility requirements:
dollar_threshold IS NOT NULL AND > 0percentage_reimbursement IS NOT NULLnetwork_id IS NOT NULLsetting = 'Inpatient'- The (payer, network, state) cluster has ≥ 5 contributing providers
- The modal structure (type combination + banded values) has ≥ 80% agreement across contributors
Clustering:
- Contributors are bucketed into type-bands:
FLOOR(dollar_threshold / 25000)(25K bands) andFLOOR(percentage_reimbursement / 5)(5-point bands) - The dominant cluster (largest count, tiebroken alphabetically) is selected
type_agreement_rate = modal_cluster_count / total_contributor_count
Threshold calculation:
- Find the median contributor within the modal cluster (by raw
dollar_threshold) - Apply CCR adjustment:
COALESCE(median_norm_threshold × recipient_ip_ccr_relativity, median_raw_threshold)median_norm_threshold = median_raw_threshold / source_ip_ccr_relativity- Final value = normalized threshold × recipient's CCR relativity
- Falls back to raw median if CCR relativity is unavailable or out of range
Traceability fields
| Field | Description |
|---|---|
ref_n_contributors | Number of providers in the modal cluster |
ref_n_hs_contributors | Number of distinct health systems in the modal cluster |
ref_agreement_rate | Fraction of total (payer, network, state) contributors that matched the modal cluster |
source_provider_id | Provider ID of the median contributor |
source_threshold_value | Raw median threshold before CCR adjustment |
calc_threshold_value | Final CCR-adjusted threshold |
ref_ccr_relativity | Recipient provider's CCR relativity used in adjustment |
Aggregated
Broad fallbacks using the most common stoploss structure across progressively wider populations. Applied when no provider- or network-specific data is available.
Score 3 — Payer + Network + State (provisions_stoploss_agg_payer_net_state)
Uses the most common stoploss structure across all observed providers in the same payer, network, and state. No minimum contributor count required. Dollar thresholds are adjusted for each hospital's charge structure.
Source: MRF — all inpatient rows with a classified stoploss type for this payer, network, and state
Recipients: All providers in that payer, network, and state
Expanded to: (payer, network, state) → (provider, payer, network)
How this differs from Score 4
How it differs from Network inference (Score 4):
- No minimum contributor count or agreement rate threshold required
- Uses all inpatient MRF rows with
stoploss_type IS NOT NULL - Groups by
(payer_id, network_id, provider_state)— payer-specific
Structure selection: Most common (stoploss_type, threshold_type, reimbursement_type) combination per group, tiebroken alphabetically.
Threshold calculation: Median threshold_value across contributors in the dominant structure, CCR-adjusted using the same formula as network inference.
Traceability fields
| Field | Description |
|---|---|
ref_n_contributors | Number of providers contributing to the dominant structure |
ref_agreement_rate | Dominant structure's share of total providers in the group |
source_id | Rate ID of the median contributor |
source_threshold_value | Raw median threshold |
calc_threshold_value | CCR-adjusted threshold |
ref_ccr_relativity | Recipient's CCR relativity |
Score 2 — Payer + Network National (provisions_stoploss_agg_payer_net_national)
Same as Score 3 but applied nationally rather than by state. The threshold is a raw national median with no adjustment for individual hospital charge structures.
Source: MRF — all inpatient rows for this payer and network, nationally
Recipients: All providers in that payer and network
Expanded to: (payer, network) → (provider, payer, network)
How this differs from Score 3
- Groups by
(payer_id, network_id)— no state filter - No minimum contributor count or agreement rate threshold required
- Uses all inpatient MRF rows with a classified stoploss type for that payer and network
- No CCR adjustment — raw national median threshold is used as-is
Structure selection: Most common (stoploss_type, threshold_type, reimbursement_type) combination per group, tiebroken alphabetically.
Traceability fields
| Field | Description |
|---|---|
ref_n_contributors | Number of providers contributing to the dominant structure |
ref_agreement_rate | Dominant structure's share of total providers in the group |
source_id | Rate ID of the median contributor |
source_threshold_value | Raw national median threshold (no CCR adjustment applied) |
Score 1 — State (provisions_stoploss_agg_state)
Uses the most common stoploss structure across all providers in the same state, regardless of payer or network. Applied when no payer- or network-specific data is available. Dollar thresholds are adjusted for each hospital's charge structure.
Source: MRF — all inpatient rows in this state, across all payers and networks
Recipients: All providers in that state
Expanded to: state → (provider, payer, network)
How this differs from Score 2
- Groups by
provider_stateonly — crosses all payers and networks - No minimum contributor count or agreement rate threshold required
- Uses all inpatient MRF rows with a classified stoploss type in that state
- CCR adjustment applied — thresholds normalized for differences in hospital charge structures
Structure selection: Most common (stoploss_type, threshold_type, reimbursement_type) combination per state, tiebroken alphabetically.
Traceability fields
| Field | Description |
|---|---|
ref_n_contributors | Number of providers contributing to the dominant structure |
ref_agreement_rate | Dominant structure's share of total providers in the state |
source_id | Rate ID of the median contributor |
source_threshold_value | Raw median threshold before CCR adjustment |
calc_threshold_value | Final CCR-adjusted threshold |
ref_ccr_relativity | Recipient provider's CCR relativity used in adjustment |
Score 0 — National Fallback (provisions_stoploss_agg_national)
Universal fallback — guarantees every provider-payer-network has at least one row.
Source: MRF — all inpatient rows nationally
Recipients: Every provider-payer-network in the universe
Expanded to: national → all rows
How this differs from Score 1
- No geographic grouping — computed once across all inpatient MRF data
- No minimum contributor count or agreement rate threshold required
- No CCR adjustment — raw national median threshold is used as-is
Structure selection: Single most common (stoploss_type, threshold_type, reimbursement_type) combination across all observed inpatient MRF data, tiebroken alphabetically.
Traceability fields
| Field | Description |
|---|---|
ref_n_contributors | Total number of providers contributing to the national structure |
ref_agreement_rate | Dominant structure's share of all national contributors |
source_id | Rate ID of the median contributor |
source_threshold_value | Raw national median threshold (no CCR adjustment applied) |
Layer 4: Combine
Combined Table: provisions_stoploss_combined
All 11 sources (scores 0–10) are combined. For each provider-payer-network, the row with the highest confidence score is kept, with full provider and payer context joined back.
Output schema
Provider metadata:
| Column | Type | Description |
|---|---|---|
provider_id | VARCHAR | |
provider_name | VARCHAR | |
payer_id | VARCHAR | |
payer_name | VARCHAR | |
network_id | BIGINT | |
network_name | VARCHAR | |
setting | VARCHAR | Always 'Inpatient' |
healthsystem_id | VARCHAR | |
healthsystem_name | VARCHAR | |
provider_state | VARCHAR | |
provider_city | VARCHAR | |
provider_county | VARCHAR | |
provider_latitude | DOUBLE | |
provider_longitude | DOUBLE | |
provider_type | VARCHAR | |
provider_subtype | VARCHAR | |
total_licensed_beds | INTEGER | |
net_patient_revenue | DOUBLE | |
national_net_patient_revenue_rank | INTEGER | |
state_net_patient_revenue_rank | INTEGER | |
payer_state_covered_lives | DOUBLE | |
payer_state_covered_lives_pct_of_total | DOUBLE |
Stoploss provision fields:
| Column | Type | Description |
|---|---|---|
canonical_source | VARCHAR | Source label (see score table above) |
canonical_score | INTEGER | 0–10 |
canonical_stoploss_type | VARCHAR | 'first dollar', 'second dollar', or NULL |
canonical_threshold_type | VARCHAR | 'dollar', 'LOS', 'none', or NULL |
canonical_threshold_value | DOUBLE | Dollar amount or day count |
canonical_reimbursement_type | VARCHAR | 'percentage', 'per diem', or NULL |
canonical_reimbursement_value | DOUBLE | Percentage or per diem dollar amount |
canonical_nte_value | DOUBLE | Cap per day, when present |
canonical_nte_type | VARCHAR | 'dollars per day' or NULL |
traceability | VARCHAR | JSON documenting source IDs, contributor counts, CCR adjustments, and original note text |
Abridged Table: provisions_stoploss_abridged
Same as combined but without traceability metadata.
Traceability Examples
{stoploss_type} stoploss once the {threshold_type} threshold of {threshold_value} is met, with a {reimbursement_type} reimbursement of {reimbursement_value}, not to exceed {nte_value} {nte_type}. Sourced directly from {provider_name}'s MRF record (id: {source_record_id}, {source_note_type}) and shared amongst {ref_rate_count} rate(s).
Source Note: "{source_note}"
Example (percentage): First dollar stoploss once the dollar threshold of $150,000 is met, with a percentage reimbursement of 85%. Sourced directly from Mercy General's MRF record (id: 4821903, additional_payer_notes) and shared amongst 3 rate(s).
Source Note: "Stoploss: first dollar at $150,000, 85% reimbursement thereafter."
Example (per diem): First dollar stoploss once the LOS threshold of 10 days is met, with a per diem reimbursement of $1,800, not to exceed $2,000 dollars per day. Sourced directly from Mercy General's MRF record (id: 4821903, additional_payer_notes) and shared amongst 3 rate(s).
Source Note: "Stoploss: first dollar beyond 10 days, $1,800 per diem thereafter, NTE $2,000/day."
Stoploss once the {threshold_type} threshold of {threshold_value} is met, with a {reimbursement_type} reimbursement of {reimbursement_value}, not to exceed {nte_value} {nte_type}. Sourced directly from {provider_name}'s MRF record (id: {source_record_id}, {source_note_type}) shared amongst {ref_rate_count} rate(s).
Source Note: "{source_note}"
Example: Stoploss once the dollar threshold of $100,000 is met, with a percentage reimbursement of 80%. Sourced directly from St. Luke's Medical Center's MRF record (id: 3019284, additional_payer_notes) shared amongst 1 rate(s).
Source Note: "SL provision applies at $100,000; 80% of covered charges thereafter."
{stoploss_type} stoploss once the {threshold_type} threshold of {threshold_value} is met, with a {reimbursement_type} reimbursement of {reimbursement_value}, not to exceed {nte_value} {nte_type}. Derived from {source_network_name}'s network rates in {provider_name}'s MRF (id: {source_id}) shared amongst {ref_rate_count} rate(s).
Source Note: "{source_note}"
Example: Second dollar stoploss once the dollar threshold of $200,000 is met, with a percentage reimbursement of 90%. Derived from BluePPO-National's network rates in Valley View Hospital's MRF (id: 5503812) shared amongst 2 rate(s).
Source Note: "Inpatient stoploss: second dollar, $200,000 threshold, 90% reimbursement."
{reimbursement_type} reimbursement of {reimbursement_value} ({ref_threshold_source} threshold of {ref_stoploss_threshold} used), not to exceed {nte_value} {nte_type}. Derived from remits data for {provider_name} where {ref_pct_of_total}% ({ref_lines_at_pct} of {ref_total_lines}) of high dollar remits for this payer/provider were paid at this percentage.
Rate Distribution: {ref_rate_distribution}
Example: Percentage reimbursement of 85% (mrf threshold of $125,000 used). Derived from remits data where 15.16% (47 of 310) of high dollar remits for this payer/provider were paid at this percentage.
Rate Distribution:
| Rate | Share |
|---|---|
| 85% | 62% |
| 80% | 38% |
{stoploss_type} stoploss once the {threshold_type} threshold of {threshold_value} is met, with a {reimbursement_type} reimbursement of {reimbursement_value}, not to exceed {nte_value} {nte_type}. Inherited from {source_hs_name} (HS id: {source_hs_id}) peer {source_provider_name} (provider_id: {source_provider_id}) for {source_payer_name} (payer id: {source_payer_id}) / {source_network_name} (network id: {source_network_id}).
Source Note: "{source_note}"
Example: First dollar stoploss once the dollar threshold of $175,000 is met, with a percentage reimbursement of 85%. Inherited from Northside Health System (HS id: 9901) peer Northside Medical Center (provider_id: 1245678) for United Healthcare (payer id: 87023) / UHC-Choice-Plus (network id: 4412).
Source Note: "Inpatient stoploss at $175,000, 85% reimbursement, first dollar."
{stoploss_type} stoploss once the {threshold_type} threshold of {threshold_value} is met, with a {reimbursement_type} reimbursement of {reimbursement_value}, not to exceed {nte_value} {nte_type}. Inherited from a {source_hs_name} (HS id: {source_hs_id}) peer under their {source_network_name} network.
Source Note: "{source_note}"
Example: First dollar stoploss once the dollar threshold of $100,000 is met, with a percentage reimbursement of 80%. Inherited from an Eastside Health Partners (HS id: 7741) peer under their CignaPPO-SE network.
Source Note: "SL: $100,000 aggregate, 80% reimbursement above threshold."
{stoploss_type} stoploss once the {threshold_type} threshold of {calc_threshold_value} is met, with a {reimbursement_type} reimbursement of {reimbursement_value}, not to exceed {nte_value} {nte_type}. Inferred from {ref_n_contributors} providers across {ref_n_hs_contributors} health systems sharing this network, {ref_agreement_rate} of whom share this stoploss structure. Threshold based on the median threshold of {source_threshold_value} (from provider id {source_provider_id}), adjusted to {calc_threshold_value} using this provider's cost-to-charge relativity of {ref_ccr_relativity}.
Example: First dollar stoploss once the dollar threshold of $112,500 is met, with a percentage reimbursement of 85%. Inferred from 12 providers across 5 health systems sharing this network, 91.67% of whom share this stoploss structure. Threshold based on the median threshold of $150,000 (from provider id 1093847), adjusted to $112,500 using this provider's cost-to-charge relativity of 0.7500.
{stoploss_type} stoploss once the {threshold_type} threshold of {calc_threshold_value} is met, with a {reimbursement_type} reimbursement of {reimbursement_value}, not to exceed {nte_value} {nte_type}. Aggregated from {ref_n_contributors} providers in the same payer/network/state group, {ref_agreement_rate} of whom share this stoploss structure. Threshold based on the median threshold of {source_threshold_value} (from record id {source_id}), adjusted to {calc_threshold_value} using this provider's cost-to-charge relativity of {ref_ccr_relativity}.
Source Note: "{source_note}"
Example: First dollar stoploss once the dollar threshold of $160,000 is met, with a percentage reimbursement of 85%. Aggregated from 8 providers in the same payer/network/state group, 87.50% of whom share this stoploss structure. Threshold based on the median threshold of $200,000 (from record id 2204719), adjusted to $160,000 using this provider's cost-to-charge relativity of 0.8000.
Source Note: "Inpatient: stoploss provision at $200,000; 85% of billed charges."
{stoploss_type} stoploss once the {threshold_type} threshold of {threshold_value} is met, with a {reimbursement_type} reimbursement of {reimbursement_value}, not to exceed {nte_value} {nte_type}. Aggregated from {ref_n_contributors} providers nationally under the same payer/network, {ref_agreement_rate} of whom share this stoploss structure; median threshold of {threshold_value} sourced from record id {source_id}.
Source Note: "{source_note}"
Example: First dollar stoploss once the dollar threshold of $175,000 is met, with a percentage reimbursement of 80%. Aggregated from 21 providers nationally under the same payer/network, 80.95% of whom share this stoploss structure; median threshold of $175,000 sourced from record id 3310482.
Source Note: "First dollar stoploss at $175,000, reimbursement at 80%."
{stoploss_type} stoploss once the {threshold_type} threshold of {calc_threshold_value} is met, with a {reimbursement_type} reimbursement of {reimbursement_value}, not to exceed {nte_value} {nte_type}. Aggregated from {ref_n_contributors} providers across the state, {ref_agreement_rate} of whom share this stoploss structure. Threshold based on the median threshold of {source_threshold_value} (from record id {source_id}), adjusted to {calc_threshold_value} using this provider's cost-to-charge relativity of {ref_ccr_relativity}.
Source Note: "{source_note}"
Example: First dollar stoploss once the dollar threshold of $93,750 is met, with a percentage reimbursement of 85%. Aggregated from 44 providers across the state, 79.55% of whom share this stoploss structure. Threshold based on the median threshold of $125,000 (from record id 1198023), adjusted to $93,750 using this provider's cost-to-charge relativity of 0.7500.
Source Note: "Stoploss applies at $125,000; 85% reimbursement applies thereafter."
{stoploss_type} stoploss once the {threshold_type} threshold of {threshold_value} is met, with a {reimbursement_type} reimbursement of {reimbursement_value}, not to exceed {nte_value} {nte_type}. Universal national fallback aggregated from {ref_n_contributors} providers, {ref_agreement_rate} of whom share this stoploss structure; median threshold of {threshold_value} sourced from record id {source_id}.
Source Note: "{source_note}"
Example: First dollar stoploss once the dollar threshold of $150,000 is met, with a percentage reimbursement of 85%. Universal national fallback aggregated from 312 providers, 76.28% of whom share this stoploss structure; median threshold of $150,000 sourced from record id 9900001.
Source Note: "Inpatient stoploss: $150,000 threshold, 85% reimbursement, first dollar basis."