Home › Open data

The Federal IDR Tables, Machine-Readable

The Departments publish the Federal IDR supplemental tables as XLSX workbooks and nothing else. These are the same figures for the second half of 2025 as JSON and CSV, transcribed without adjustment, with the source sheet named in every file. Free to use. If they are useful to you, a link back is appreciated — that is how we find out they are.

The files

Five Tables, Two Formats

Machine-readable files of the Federal IDR supplemental tables for the second half of 2025
What it containsJSONCSV
Headline figures: disputes initiated and closed, closure reasons, outcomes, plan types, initiating party size, fees JSON 4 KB —
Disputes initiated by state and territory, with the specified-state-law flag (Table 7) JSON 13 KB CSV 2 KB
Median prevailing offer relative to QPA by CPT category (Table 14) JSON 11 KB CSV 3 KB
Median prevailing offer relative to QPA by claim size (Table 13) JSON 3 KB CSV 248 B
Most frequently disputed non-initiating parties, with plan-type breakdown (Table 9) JSON 6 KB CSV 742 B

A manifest lists every file with its size and URL. Each file carries the publisher, the document title, the source table and the date CMS last updated it.

Read this first

Three Things That Will Trip You Up

The units changed between 2024 and 2025. In the 2025 workbooks the column headed “Median Prevailing offer as % of QPA” holds a percentage — 522. In the 2024 workbooks the same column holds a ratio — 5.53. Read a 2025 sheet with 2024 assumptions and every multiple comes out a hundred times too large. In these files the value is always a ratio.

Table 9 is a per-quarter top ten, not a half-year list. Its membership changed between Q3 and Q4 2025: Centene entered, BCBS Florida left. Adding the two lists blindly understates anyone present in only one quarter, so each row here records which quarters it covers.

The state rows do not sum to the national total. Table 7 sums to 1,376,390 while Table 1 gives 1,372,563 disputes initiated. CMS publishes both and does not reconcile them in the report; neither do we. Both figures appear as published.

Field dictionary

What Every Field Means

states-h2-2025 — Disputes by state and territory

Fields in states-h2-2025
FieldWhat it holds
rankRank by disputes initiated in the half-year, 1 = most
stateState or territory as named by CMS
q3_2025Count of disputes, as published.
q4_2025Count of disputes, as published.
h2_2025Sum of the two quarters
air_ambulance_h2_2025Disputes involving out-of-network air ambulance services, included in h2_2025
specified_state_lawWhether CMS flags the state as having a specified state law or All-Payer Model Agreement covering these disputes. This is what decides whether a given claim can go to a state process at all.

specialties-h2-2025 — Prevailing offers by CPT category

Fields in specialties-h2-2025
FieldWhat it holds
cpt_rangeCPT code range as published
categorySpecialty category as named by CMS
q3_2025_multipleRatio of the median prevailing offer to the plan's qualifying payment amount. CMS reports this column as a percentage in the 2025 workbooks (522) and as a ratio in the 2024 workbooks (5.53); the value here is always a ratio.
q4_2025_multipleRatio of the median prevailing offer to the plan's qualifying payment amount. CMS reports this column as a percentage in the 2025 workbooks (522) and as a ratio in the 2024 workbooks (5.53); the value here is always a ratio.
determinations_h2_2025Payment determinations, sum of the two quarters
items_or_services_h2_2025Items or services covered by those determinations, sum of the two quarters. Dividing this by determinations gives the average number of items per determination, which is one way to see batching intensity.

cost-bands-h2-2025 — Prevailing offers by claim size

Fields in cost-bands-h2-2025
FieldWhat it holds
qpa_rangeCost band of the qualifying payment amount, as published
q3_2025_multipleRatio of the median prevailing offer to the plan's qualifying payment amount. CMS reports this column as a percentage in the 2025 workbooks (522) and as a ratio in the 2024 workbooks (5.53); the value here is always a ratio.
q4_2025_multipleRatio of the median prevailing offer to the plan's qualifying payment amount. CMS reports this column as a percentage in the 2025 workbooks (522) and as a ratio in the 2024 workbooks (5.53); the value here is always a ratio.
determinations_h2_2025Payment determinations, sum of the two quarters

payers-h2-2025 — Most frequently disputed parties

Fields in payers-h2-2025
FieldWhat it holds
partyNon-initiating party or representative, as named by CMS. The term is the Departments' own and carries no finding about conduct.
disputes_h2_2025Sum of the quarters in which the party appears in the table
self_insuredDisputes where the plan is a partly or fully self-insured employer plan. ERISA prevents states from regulating these, so they go through the federal process regardless of state law.
fully_insuredDisputes involving a fully insured private group health plan
individual_marketDisputes involving an individual health insurance issuer
fehbDisputes involving a Federal Employees Health Benefits carrier
non_federal_governmentDisputes involving a state or local government plan. ERISA does not reach these.
churchDisputes involving a church plan
no_issuer_responseDisputes where the issuer did not respond and the plan type was never established
quarters_presentWhich quarters the party appears in. Table 9 is a per-quarter top ten and its membership changed between Q3 and Q4 2025, so a party present in only one quarter has a one-quarter total.

The headline file federal-idr-h2-2025.json is nested rather than tabular: it holds dispute counts, closure reasons, determination outcomes, the plan-type split, the initiating-party size distribution, process fees, and the same figures for the first half of 2025 for comparison. Every key is spelled out in full, and the same field descriptions travel inside each file.

Getting started

Three Lines to a Table

The files are served with an open CORS header, so they work from a browser, a notebook or a script without a proxy.

import pandas as pd
states = pd.read_csv("https://www.proprius-recovery.com/data/states-h2-2025.csv")
states.nlargest(10, "h2_2025")[["state", "h2_2025", "specified_state_law"]]

Or, to check one figure without leaving the shell:

curl -s https://www.proprius-recovery.com/data/federal-idr-h2-2025.json | jq '.outcomes'

If you are building something that needs to notice when the figures change, https://www.proprius-recovery.com/data/manifest.json lists every file with its size, and each file carries the date CMS last updated the source workbooks. The Departments publish quarterly; we update after they do.

Scope

What This Is, and What It Is Not

It is a transcription. Every number comes from the published federal tables for the period 1 July to 31 December 2025, which CMS last updated on 22 July 2026. Nothing is estimated, modelled, weighted or adjusted. Where a field is the sum of two quarters, the field name says so.

It is not a dataset about this company, and it contains no information about any dispute we have handled. It carries no analysis: what the numbers mean is argued on the data pages, not in the files.

The underlying figures are a work of the United States government. We claim nothing over them. The arrangement here is free to use for any purpose, including commercially, with or without credit.

Source: U.S. Departments of Health and Human Services, Labor, and the Treasury, Supplemental Background on Federal Independent Dispute Resolution Public Use Files, July 1, 2025 – December 31, 2025, and the accompanying Federal IDR Supplemental Tables for 2025 Q3 and 2025 Q4. CMS publishes the workbooks and the report here.