# CMS Hospital Price Transparency Scraper (`jungle_synthesizer/cms-hospital-price-transparency-scraper`) Actor

Extract hospital standard charges from CMS-mandated machine-readable files (MRF). Parses CMS v1/v2/v3 JSON schemas into rows by billing code (CPT, HCPCS, MS-DRG, NDC) and payer/plan. Fetches hospital identity from the CMS enrollment dataset. Filter by state, CCN, code type, billing code, or payer.

- **URL**: https://apify.com/jungle\_synthesizer/cms-hospital-price-transparency-scraper.md
- **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community)
- **Categories:** Business, Other, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## CMS Hospital Price Transparency Scraper

Scrapes hospital standard charges from machine-readable files mandated by the [CMS Hospital Price Transparency rule](https://www.cms.gov/priorities/key-initiatives/hospital-price-transparency). Parses CMS JSON schemas (v1, v2, v3) into structured rows by billing code — CPT, HCPCS, MS-DRG, Revenue Code, NDC — payer, and plan. Also retrieves hospital identity data for ~6,000 US hospitals from the CMS enrollment dataset.

---

### CMS Hospital Price Transparency Scraper Features

- Parses CMS JSON MRF files (v1/v2 flat schema and v3 nested schema) from any user-supplied URL
- Auto-detects schema version — no configuration needed
- Returns negotiated rates by payer and plan: dollar amounts, percentages, and algorithm descriptions
- Returns gross charges, cash/self-pay prices, and de-identified min/max rates
- Fetches hospital identity records (CCN, NPI, address) from the CMS enrollment dataset
- Filters by billing code type (CPT, HCPCS, MS-DRG, RC, NDC), specific billing code, payer name substring, or state
- Three modes: `mrf_parse` for a single file URL, `hospital_list` for enrollment data, `discover_and_parse` for the combined pipeline
- No proxy required — CMS and GitHub are open public APIs

---

### Who Uses CMS Hospital Price Transparency Data?

- **Healthcare price-comparison startups** — Build comparison tools on top of actual negotiated rates across hospitals and payers
- **Employers and self-funded health plans** — Compare in-network rates to negotiate better contracts or choose preferred networks
- **Benefits consultants and brokers** — Analyze payer/plan rate variation for clients by procedure code
- **Journalists and researchers** — Track compliance, investigate pricing disparities, publish hospital cost analyses
- **Healthcare data vendors** — Supplement CMS enrollment records with charge data to build comprehensive hospital intelligence datasets
- **Academic institutions** — Study pricing patterns across regions, facility types, and payer mixes

---

### How CMS Hospital Price Transparency Scraper Works

1. Pick a mode. `mrf_parse` takes a single MRF URL and parses it. `hospital_list` pages through the CMS enrollment dataset and returns hospital identity records. `discover_and_parse` does both.
2. For MRF parsing, the scraper fetches the JSON file and auto-detects whether it uses the v3 nested schema (with `standard_charges[]` and `payers_information[]`) or the v1/v2 flat schema. It handles both without any configuration.
3. Apply optional filters — billing code type, specific code, payer name substring — and the scraper applies them during parsing so only matching rows reach the output.
4. Results land in the Apify dataset as structured JSON. One row per payer/plan combination per billing code per service setting, which is as granular as the CMS standard requires.

---

### Input

```json
{
  "mode": "mrf_parse",
  "mrfUrl": "https://example-hospital.com/standard-charges.json",
  "billingCodeType": "CPT",
  "maxItems": 1000,
  "sp_intended_usage": "Rate comparison for employer health plan negotiation",
  "sp_improvement_suggestions": "None"
}
````

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `mode` | string | `mrf_parse` | `mrf_parse` parses a single MRF URL. `hospital_list` returns CMS enrollment records. `discover_and_parse` combines both. |
| `mrfUrl` | string | — | MRF JSON URL to fetch and parse. Required for `mrf_parse` mode. |
| `stateFilter` | string | — | Two-letter state code (e.g. `CA`, `TX`). Filters hospital list results. |
| `hospitalCcn` | string | — | CMS Certification Number to filter to a single hospital. |
| `billingCodeType` | string | — | Filter by code system: `CPT`, `HCPCS`, `MS-DRG`, `APR-DRG`, `RC`, `NDC`, or `Internal`. Leave blank for all. |
| `billingCode` | string | — | Specific billing code to filter (e.g. `70551`). Leave blank for all. |
| `payerFilter` | string | — | Case-insensitive payer name substring filter. |
| `maxItems` | integer | `15` | Maximum records to return. `0` = unlimited. |

#### Hospital List Mode Input

```json
{
  "mode": "hospital_list",
  "stateFilter": "TX",
  "maxItems": 500,
  "sp_intended_usage": "Building a hospital database for Texas",
  "sp_improvement_suggestions": "None"
}
```

***

### CMS Hospital Price Transparency Scraper Output Fields

#### MRF Parse Mode

Returns one row per payer/plan/billing code combination.

```json
{
  "hospital_name": "EXAMPLE REGIONAL MEDICAL CENTER",
  "hospital_ccn": "",
  "hospital_npi": "",
  "hospital_address": "",
  "hospital_city": "",
  "hospital_state": "",
  "hospital_zip": "",
  "mrf_url": "https://example-hospital.com/standard-charges.json",
  "mrf_version": "3.0.0",
  "mrf_last_updated": "2025-01-15",
  "billing_code": "70551",
  "billing_code_type": "CPT",
  "description": "MRI Brain without contrast",
  "payer_name": "Aetna",
  "plan_name": "Aetna PPO Standard",
  "setting": "outpatient",
  "methodology": "fee schedule",
  "standard_charge_gross": 4200,
  "standard_charge_discounted_cash": 1890,
  "standard_charge_negotiated_dollar": 1240,
  "standard_charge_negotiated_percentage": null,
  "standard_charge_negotiated_algorithm": "",
  "standard_charge_min": 980,
  "standard_charge_max": 1600,
  "estimated_amount": 1240,
  "additional_payer_notes": "",
  "record_type": "charge_row"
}
```

| Field | Type | Description |
|-------|------|-------------|
| `hospital_name` | string | Hospital name from MRF header |
| `hospital_ccn` | string | CMS Certification Number (populated in hospital\_list mode) |
| `hospital_npi` | string | National Provider Identifier |
| `hospital_address` | string | Street address |
| `hospital_city` | string | City |
| `hospital_state` | string | State abbreviation |
| `hospital_zip` | string | ZIP code |
| `mrf_url` | string | Source MRF file URL |
| `mrf_version` | string | CMS schema version (e.g. `3.0.0`) |
| `mrf_last_updated` | string | Date the MRF was last updated |
| `billing_code` | string | Billing code (e.g. `70551`) |
| `billing_code_type` | string | Code system: CPT, HCPCS, MS-DRG, RC, NDC, Internal |
| `description` | string | Service or item description |
| `payer_name` | string | Payer name |
| `plan_name` | string | Plan name |
| `setting` | string | Service setting: inpatient, outpatient, or both |
| `methodology` | string | Rate methodology (fee schedule, percent of total billed charges, etc.) |
| `standard_charge_gross` | number | Gross / chargemaster price |
| `standard_charge_discounted_cash` | number | Cash / self-pay discount price |
| `standard_charge_negotiated_dollar` | number | Negotiated dollar amount |
| `standard_charge_negotiated_percentage` | number | Negotiated percentage of gross charge |
| `standard_charge_negotiated_algorithm` | string | Algorithm description when rate is formula-based |
| `standard_charge_min` | number | De-identified minimum negotiated charge |
| `standard_charge_max` | number | De-identified maximum negotiated charge |
| `estimated_amount` | number | Estimated allowed amount |
| `additional_payer_notes` | string | Additional payer or plan notes |
| `record_type` | string | `charge_row` for MRF data, `hospital_info` for enrollment data |

#### Hospital List Mode

Returns one row per hospital from the CMS enrollment dataset.

```json
{
  "hospital_name": "MEMORIAL HOSPITAL OF LARAMIE COUNTY",
  "hospital_ccn": "530012",
  "hospital_npi": "1568469223",
  "hospital_address": "214 E 23RD ST",
  "hospital_city": "CHEYENNE",
  "hospital_state": "WY",
  "hospital_zip": "82001",
  "mrf_url": "",
  "mrf_version": "",
  "mrf_last_updated": "",
  "billing_code": "",
  "billing_code_type": "",
  "description": "",
  "payer_name": "",
  "plan_name": "",
  "setting": "",
  "methodology": "",
  "standard_charge_gross": null,
  "standard_charge_discounted_cash": null,
  "standard_charge_negotiated_dollar": null,
  "standard_charge_negotiated_percentage": null,
  "standard_charge_negotiated_algorithm": "",
  "standard_charge_min": null,
  "standard_charge_max": null,
  "estimated_amount": null,
  "additional_payer_notes": "",
  "record_type": "hospital_info"
}
```

***

### 🔍 FAQ

#### How do I scrape hospital prices from CMS machine-readable files?

CMS Hospital Price Transparency Scraper handles this in `mrf_parse` mode. Supply the MRF URL in the `mrfUrl` field, set optional filters, and run. The scraper fetches the file, auto-detects whether it uses CMS v1/v2 or v3 schema, and outputs one structured row per payer/plan/billing code combination.

#### Where do I find hospital MRF URLs?

CMS does not publish a single comprehensive directory of MRF URLs. Individual hospitals publish their own files on their websites, typically in a "price transparency" or "standard charges" section. The [CMS Hospital Price Transparency enforcement dataset](https://data.cms.gov/hospital-price-transparency) tracks compliance but does not always include direct file links. Third-party aggregators like Turquoise Health and Dolthub's hospital-price-transparency project maintain compiled URL lists.

#### What billing code types does this scraper support?

CMS Hospital Price Transparency Scraper supports all billing code types defined in the CMS standard: CPT, HCPCS, MS-DRG, APR-DRG, Revenue Code (RC), NDC (drug codes), and Internal. Filter using the `billingCodeType` input field.

#### How much does this scraper cost to run?

CMS Hospital Price Transparency Scraper uses pay-per-event pricing: $0.10 per run start plus $0.001 per record. A run parsing 10,000 charge rows from a single MRF file costs about $10.10. Use `maxItems` to control scope on large hospital chargemasters.

#### Does this scraper need proxies?

No. CMS data APIs and GitHub-hosted example files are public and don't require proxies. The `proxyConfiguration` input field is available if your target MRF is hosted somewhere that rate-limits, but for standard CMS data sources it isn't necessary.

#### Can I filter to a single hospital?

Yes. Use `hospitalCcn` with the hospital's CMS Certification Number to filter `hospital_list` mode. For MRF parsing, supply the specific hospital's MRF URL in `mrfUrl`.

***

### Need More Features?

Need support for CSV MRF format, streaming parsing for 1GB+ files, or a different data source? [File an issue](https://console.apify.com/actors/9CDfe4XXm9uboo5y1/issues) or get in touch.

### Why Use CMS Hospital Price Transparency Scraper?

- **CMS schema coverage** — Handles CMS v1, v2, and v3 JSON schemas with auto-detection. Most hospital-built parsers handle only one version.
- **Dual-mode output** — Returns charge rows from MRF files and hospital identity data from the CMS enrollment API in the same output schema, so you can join the two datasets without additional ETL.
- **Affordable at scale** — At $0.001 per record, parsing 100,000 charge rows costs $100, which is less than most healthcare data subscriptions charge per hospital.

# Actor input Schema

## `sp_intended_usage` (type: `string`):

Please describe how you plan to use the data extracted by this crawler.

## `sp_improvement_suggestions` (type: `string`):

Provide any feedback or suggestions for improvements.

## `sp_contact` (type: `string`):

Provide your email address so we can get in touch with you.

## `mode` (type: `string`):

hospital\_list returns hospital enrollment data from CMS. mrf\_parse fetches and parses a single MRF URL you supply. discover\_and\_parse combines hospital list with MRF parsing.

## `mrfUrl` (type: `string`):

Machine-readable file URL to fetch and parse. Required for mrf\_parse mode. Supports JSON CMS v1/v2/v3 schema.

## `stateFilter` (type: `string`):

Two-letter state code (e.g. CA, TX). Filters hospital list results. Leave blank for all states.

## `hospitalCcn` (type: `string`):

CMS Certification Number to filter to a single hospital. Leave blank for all.

## `billingCodeType` (type: `string`):

Filter charge rows by billing code system. Leave blank for all.

## `billingCode` (type: `string`):

Specific billing code to filter (e.g. 70551 for CPT Brain MRI). Leave blank for all.

## `payerFilter` (type: `string`):

Filter charge rows by payer name substring (case-insensitive). Leave blank for all.

## `maxItems` (type: `integer`):

Maximum charge rows or hospital records to return. 0 = unlimited.

## `proxyConfiguration` (type: `object`):

Proxy settings. CMS and GitHub are public APIs — proxies are typically not needed.

## Actor input object example

```json
{
  "sp_intended_usage": "Describe your intended use...",
  "sp_improvement_suggestions": "Share your suggestions here...",
  "sp_contact": "Share your email here...",
  "mode": "mrf_parse",
  "mrfUrl": "https://raw.githubusercontent.com/CMSgov/hospital-price-transparency/master/examples/JSON/v3_json_format_example.json",
  "maxItems": 15,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "sp_intended_usage": "Describe your intended use...",
    "sp_improvement_suggestions": "Share your suggestions here...",
    "sp_contact": "Share your email here...",
    "mode": "mrf_parse",
    "mrfUrl": "https://raw.githubusercontent.com/CMSgov/hospital-price-transparency/master/examples/JSON/v3_json_format_example.json",
    "stateFilter": "",
    "hospitalCcn": "",
    "billingCodeType": "",
    "billingCode": "",
    "payerFilter": "",
    "maxItems": 15,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("jungle_synthesizer/cms-hospital-price-transparency-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "sp_intended_usage": "Describe your intended use...",
    "sp_improvement_suggestions": "Share your suggestions here...",
    "sp_contact": "Share your email here...",
    "mode": "mrf_parse",
    "mrfUrl": "https://raw.githubusercontent.com/CMSgov/hospital-price-transparency/master/examples/JSON/v3_json_format_example.json",
    "stateFilter": "",
    "hospitalCcn": "",
    "billingCodeType": "",
    "billingCode": "",
    "payerFilter": "",
    "maxItems": 15,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("jungle_synthesizer/cms-hospital-price-transparency-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "sp_intended_usage": "Describe your intended use...",
  "sp_improvement_suggestions": "Share your suggestions here...",
  "sp_contact": "Share your email here...",
  "mode": "mrf_parse",
  "mrfUrl": "https://raw.githubusercontent.com/CMSgov/hospital-price-transparency/master/examples/JSON/v3_json_format_example.json",
  "stateFilter": "",
  "hospitalCcn": "",
  "billingCodeType": "",
  "billingCode": "",
  "payerFilter": "",
  "maxItems": 15,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call jungle_synthesizer/cms-hospital-price-transparency-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=jungle_synthesizer/cms-hospital-price-transparency-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "CMS Hospital Price Transparency Scraper",
        "description": "Extract hospital standard charges from CMS-mandated machine-readable files (MRF). Parses CMS v1/v2/v3 JSON schemas into rows by billing code (CPT, HCPCS, MS-DRG, NDC) and payer/plan. Fetches hospital identity from the CMS enrollment dataset. Filter by state, CCN, code type, billing code, or payer.",
        "version": "0.1",
        "x-build-id": "gh4vULYFPrjSX2Z9I"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/jungle_synthesizer~cms-hospital-price-transparency-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-jungle_synthesizer-cms-hospital-price-transparency-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/jungle_synthesizer~cms-hospital-price-transparency-scraper/runs": {
            "post": {
                "operationId": "runs-sync-jungle_synthesizer-cms-hospital-price-transparency-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/jungle_synthesizer~cms-hospital-price-transparency-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-jungle_synthesizer-cms-hospital-price-transparency-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "sp_intended_usage",
                    "sp_improvement_suggestions"
                ],
                "properties": {
                    "sp_intended_usage": {
                        "title": "What is the intended usage of this data?",
                        "minLength": 1,
                        "type": "string",
                        "description": "Please describe how you plan to use the data extracted by this crawler."
                    },
                    "sp_improvement_suggestions": {
                        "title": "How can we improve this crawler for you?",
                        "minLength": 1,
                        "type": "string",
                        "description": "Provide any feedback or suggestions for improvements."
                    },
                    "sp_contact": {
                        "title": "Contact Email",
                        "minLength": 1,
                        "type": "string",
                        "description": "Provide your email address so we can get in touch with you."
                    },
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "hospital_list",
                            "mrf_parse",
                            "discover_and_parse"
                        ],
                        "type": "string",
                        "description": "hospital_list returns hospital enrollment data from CMS. mrf_parse fetches and parses a single MRF URL you supply. discover_and_parse combines hospital list with MRF parsing.",
                        "default": "mrf_parse"
                    },
                    "mrfUrl": {
                        "title": "MRF URL",
                        "type": "string",
                        "description": "Machine-readable file URL to fetch and parse. Required for mrf_parse mode. Supports JSON CMS v1/v2/v3 schema."
                    },
                    "stateFilter": {
                        "title": "State Filter",
                        "type": "string",
                        "description": "Two-letter state code (e.g. CA, TX). Filters hospital list results. Leave blank for all states."
                    },
                    "hospitalCcn": {
                        "title": "Hospital CCN Filter",
                        "type": "string",
                        "description": "CMS Certification Number to filter to a single hospital. Leave blank for all."
                    },
                    "billingCodeType": {
                        "title": "Billing Code Type Filter",
                        "enum": [
                            "",
                            "CPT",
                            "HCPCS",
                            "MS-DRG",
                            "APR-DRG",
                            "RC",
                            "NDC",
                            "Internal"
                        ],
                        "type": "string",
                        "description": "Filter charge rows by billing code system. Leave blank for all."
                    },
                    "billingCode": {
                        "title": "Billing Code",
                        "type": "string",
                        "description": "Specific billing code to filter (e.g. 70551 for CPT Brain MRI). Leave blank for all."
                    },
                    "payerFilter": {
                        "title": "Payer Name Contains",
                        "type": "string",
                        "description": "Filter charge rows by payer name substring (case-insensitive). Leave blank for all."
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "type": "integer",
                        "description": "Maximum charge rows or hospital records to return. 0 = unlimited.",
                        "default": 15
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy settings. CMS and GitHub are public APIs — proxies are typically not needed."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
