Pricing Gap Reports
Create a Pricing Gap Report, read each section of it, and get the PDF.
These tools build and read a Pricing Gap Report. The assistant is walked through them by pgr_next_step and by the next_step on every result. The report and its sections are free; choosing your own comparison hospitals and the insurers' own rates need an upgrade.
pgr_next_step
What to do next for a report, or the whole walk when no report is named.
| Parameter | Type | Default | What it does |
|---|---|---|---|
report_id | string | none |
pgr_create_report
Start a report for one hospital against similar nearby hospitals; it builds in about a minute.
| Parameter | Type | Default | What it does |
|---|---|---|---|
hospital_id | string | required | One hospital id (UUID), as returned by find_hospitals. |
hospital_ids | list of string | none | Up to 25 hospital ids (UUIDs), as returned in the hospital_id field of earlier rows. |
prepared_for | string | none |
pgr_get_report
One report's status and headline; poll until it is ready.
| Parameter | Type | Default | What it does |
|---|---|---|---|
report_id | string | required |
pgr_list_reports
The reports in your account, newest first.
| Parameter | Type | Default | What it does |
|---|
pgr_panel_suggestions
The hospitals a report's comparison panel can be built from, with distance, beds and why.
| Parameter | Type | Default | What it does |
|---|---|---|---|
limit | integer | 20 | Most rows to return. Each tool has its own cap. On a free plan, paid data returns 8 rows whatever you ask for. |
report_id | string | required |
pgr_rebuild
Rebuild a report against today's price files, retry a failed one, or change its comparison hospitals.
| Parameter | Type | Default | What it does |
|---|---|---|---|
default_panel | boolean | false | |
hospital_ids | list of string | none | Up to 25 hospital ids (UUIDs), as returned in the hospital_id field of earlier rows. |
rebrand | boolean | false | |
report_id | string | required |
pgr_sections
Every component of a report, one tool each, with what it holds.
| Parameter | Type | Default | What it does |
|---|---|---|---|
report_id | string | required |
pgr_summary
The report's finding: codes compared, below and above the nearby median, the yearly gap range, the method.
| Parameter | Type | Default | What it does |
|---|---|---|---|
report_id | string | required |
pgr_market
CMS facts for the hospital's area and the spread of the comparison panel.
| Parameter | Type | Default | What it does |
|---|---|---|---|
report_id | string | required |
pgr_hospitals
The comparison hospitals, each head to head with this hospital, or one code by code.
| Parameter | Type | Default | What it does |
|---|---|---|---|
direction | below | above | outliers | none | |
hospital | string | none | A hospital CCN or name, or a metro or hospital id for the dataset you picked. |
limit | integer | 20 | Most rows to return. Each tool has its own cap. On a free plan, paid data returns 8 rows whatever you ask for. |
report_id | string | required | |
sort | distance | pct_below | pct_above | none | Column to sort by. |
pgr_price_position
The compared codes ranked by CMS-unit impact.
| Parameter | Type | Default | What it does |
|---|---|---|---|
limit | integer | 20 | Most rows to return. Each tool has its own cap. On a free plan, paid data returns 8 rows whatever you ask for. |
offset | integer | 0 | Rows to skip, for paging. |
report_id | string | required |
pgr_vs_market
The codes priced furthest below or above the nearby median.
| Parameter | Type | Default | What it does |
|---|---|---|---|
limit | integer | 20 | Most rows to return. Each tool has its own cap. On a free plan, paid data returns 8 rows whatever you ask for. |
offset | integer | 0 | Rows to skip, for paging. |
report_id | string | required | |
side | below | above | below |
pgr_service_lines
Per service line: codes compared, the median gap and the yearly gap.
| Parameter | Type | Default | What it does |
|---|---|---|---|
limit | integer | 20 | Most rows to return. Each tool has its own cap. On a free plan, paid data returns 8 rows whatever you ask for. |
report_id | string | required | |
setting | inpatient | outpatient | none | Only inpatient or only outpatient lines. |
pgr_inpatient
Insurers' published DRG prices here against the same insurer nearby, and the contract terms they publish.
| Parameter | Type | Default | What it does |
|---|---|---|---|
limit | integer | 20 | Most rows to return. Each tool has its own cap. On a free plan, paid data returns 8 rows whatever you ask for. |
payer | string | none | Only this insurer, as named in the data. |
report_id | string | required |
pgr_published
The codes that make up 80% of the hospital's estimated revenue, with their cumulative share.
| Parameter | Type | Default | What it does |
|---|---|---|---|
limit | integer | 20 | Most rows to return. Each tool has its own cap. On a free plan, paid data returns 8 rows whatever you ask for. |
offset | integer | 0 | Rows to skip, for paging. |
report_id | string | required |
pgr_payer_teaser
The insurer most of the comparison hospitals publish rates for, and the others.
| Parameter | Type | Default | What it does |
|---|---|---|---|
report_id | string | required |
pgr_payer_rates
Each insurer's facility rate here against its median nearby, per code; needs the insurer payer-rates add-on.
| Parameter | Type | Default | What it does |
|---|---|---|---|
codes | list of string | none | CPT, HCPCS or MS-DRG codes to look up. |
direction | below | above | none | |
limit | integer | 20 | Most rows to return. Each tool has its own cap. On a free plan, paid data returns 8 rows whatever you ask for. |
payer | string | none | Only this insurer, as named in the data. |
report_id | string | required |
pgr_codes
Every compared code with its target price, filtered by direction, service line, setting or codes.
| Parameter | Type | Default | What it does |
|---|---|---|---|
codes | list of string | none | CPT, HCPCS or MS-DRG codes to look up. |
direction | below | above | outliers | none | |
limit | integer | 20 | Most rows to return. Each tool has its own cap. On a free plan, paid data returns 8 rows whatever you ask for. |
report_id | string | required | |
service_line | string | none | |
setting | inpatient | outpatient | none | Only inpatient or only outpatient lines. |
sort | opportunity | pct_below | pct_above | volume | code | none | Column to sort by. |
pgr_what_if
What a uniform raise or a capture share of the gap would bring in a year.
| Parameter | Type | Default | What it does |
|---|---|---|---|
capture_pct | number | none | |
report_id | string | required | |
uplift_pct | number | none |
pgr_sources
Every hospital's price file, the CMS datasets used, and the disclaimer.
| Parameter | Type | Default | What it does |
|---|---|---|---|
report_id | string | required |
pgr_export_pdf
The report as a branded PDF, as a download link valid for an hour.
| Parameter | Type | Default | What it does |
|---|---|---|---|
report_id | string | required |