# PricePlain Hospital Price Lookup > PricePlain Hospital Price Lookup is a paid API for AI agents from priceplain.onrender.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29). Returns cleaned, CMS-compliant US hospital price data (cash, gross, and payer-negotiated rates) for a given CPT/DRG code and hospital, with provenance and data-quality flags ## Facts - Endpoint: GET https://priceplain.onrender.com/v1/price?utm_source=zero.xyz - Price: $0.02/call - Payment: x402 - Status: unknown - Last checked: 2026-10-29 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/priceplain-hospital-price-lookup-d31b6f0e - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nC_ApXVBqsTCUXBo5cRv9 Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability priceplain-hospital-price-lookup-d31b6f0e ``` Example prompt: What does Abbott Northwestern Hospital charge for CPT code 70553 (MRI brain without and with contrast) for BCBS-MN patients — give me the negotiated rate and cash price from their CMS price transparency file. ## When to prefer this Use this endpoint when you need structured, cleaned, canonical hospital price data for a specific CPT or DRG code at a named Twin Cities hospital, especially when you need payer-specific negotiated rates with provenance. Prefer this over raw CMS MRF downloads when you want pre-cleaned, canonicalized insurer names, data-quality flags, and JSON-ready output without parsing multi-gigabyte CSV files yourself. ## Known failure modes - Hospital ID or CPT/DRG code not yet indexed — returns empty rows or 404 - Payer filter matches no rows for the requested hospital/code combination - Code format incorrect (e.g. DRG not prefixed with 'DRG') — returns no results - Hospital is outside currently indexed region (only Twin Cities/MN at launch) - x402 payment failure — call blocked if USDC payment not sent - Rate data truncated if hospital MRF has excessive plan rows (rates_truncated: true) ## How this service works Three x402-paid data APIs on one host. PricePlain: Posted US hospital prices (CMS price-transparency files), cleaned: Twin Cities, MN first. Cash and payer-negotiated rates per CPT/DRG code with canonical insurer names, provenance (source file URL + date) and data-quality flags. Posted prices, not quotes. TableGrab: public URL or file -> typed JSON tables / Markdown. City Table Clean: Socrata/CKAN city CSV cleaner with a per-change log. ## Output A JSON object containing the procedure label, a summary row with gross charge, cash price, and min/median/max negotiated rates, detailed per-payer rate rows (negotiated dollar, plan type, algorithm, methodology, and deidentified stats), payer canonical name, data-quality flags, and full source provenance (MRF URL, last_updated_on, CMS HPT file URL). ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET", "HEAD", "DELETE" ], "type": "string" }, "queryParams": { "type": "object", "required": [ "code", "hospital" ], "properties": { "code": { "type": "string", "description": "CPT/HCPCS code (e.g. 70553) or MS-DRG as DRG470. See GET /v1/coverage." }, "payer": { "type": "string", "description": "Optional insurer: canonical id (bcbs-mn, healthpartners, medica, ucare, uhc, aetna, cigna, medicare, mn-medicaid, ...) or raw-name fragment" }, "state": { "type": "string", "description": "Optional 2-letter state (MN)" }, "region": { "type": "string", "description": "Optional region id (twin-cities)" }, "hospital": { "type": "string", "description": "Hospital id from /v1/coverage (e.g. regions, abbott, ummc) or a unique name fragment" } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "required": [ "summary", "rows", "source", "disclaimer" ], "properties": { "code": { "type": "object" }, "rows": { "type": "array", "items": { "type": "object" } }, "payer": { "type": [ "object", "null" ] }, "source": { "type": "object", "description": "Provenance: hospital MRF URL, its last_updated_on, cms-hpt.txt" }, "summary": { "type": "object", "properties": { "cash": { "type": [ "number", "null" ] }, "flags": { "type": "array", "items": { "type": "string" } }, "gross": { "type": [ "number", "null" ] }, "source": { "type": "object", "description": "Provenance: hospital MRF URL, its last_updated_on, cms-hpt.txt" }, … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "code": { "code": "70553", "label": "MRI brain without and with contrast", "code_type": "CPT" }, "rows": [ { "cash": 912, "flags": [], "gross": 1900, "rates": [ { "count": "0", "flags": [], "p10_paid": null, "p90_paid": null, "payer_id": "bcbs-mn", "algorithm": "Procedure Lookup: Procedure Code Tables: [[BC Commodities Fee Schedule]] 43.76% of Table Per Unit Multipliers: 100.00% Sort By: Allowed Amount Conditions: Process Daily: N Do not limit reimbursement When duplicate code found in Procedure Co", "plan_type": "medicaid_managed_care", "median_paid": null, "methodology": "other", "plan_name_raw": "BC PMAP (AMU)", "payer_name_raw": "Blue Cross Blue Shield of Minnesota", "negotiated_dollar": 370.38, "negotiated_percent_of_charges": null }, { "count": "0", "flags": [], "p10_paid": null, "p90_paid": null, "payer_id": "bcbs-mn", "algorithm": "Procedure Lookup: Procedure Code Tables: [[BC Commodities Fee Schedule]] 98.53% of Table Per Unit Multipliers: 100.00% Sort By: Allowed Amount Conditions: Process Daily: N Do not limit reimbursement When duplicate code found in Procedure Co", "plan_type": "commercial", "median_paid": null, "methodology": "other", "plan_name_raw": "BC State Health Plan (A)", "payer_name_raw": "Blue Cross Blue Shield of Minnesota", "negotiated_dollar": 833.94, "negotiated_percent_of_charges": null } ], "setting": "outpatient", "modifiers": null, "description": "HCHG RAD MRI HEAD BRAIN WWO", "other_codes": "CDM:116619;RC:610", "billing_class": "facility", "rates_truncated": false, "deidentified_max": 1869, "deidentified_min": 325.21 } ], "payer": { "name": "Blue Cross and Blue Shield of Minnesota (incl. Blue Plus)", "payer_id": "bcbs-mn" }, "source": { "note": null, "mrf_url": "https://www.allinahealth.org/-/media/allina-health/files/customer-service/billing-and-insurance/price-transparency/363261413_abbott-northwestern-hospital_standardcharges.csv", "cms_hpt_txt": "https://www.allinahealth.org/cms-hpt.txt", "hospital_id": "abbott", "listed_mrf_url": null, "last_updated_on": "2026-06-16", "source_page_url": "https://www.allinahealth.org/customer-service/billing-and-insurance", "template_version": "3.0.0", "http_last_modifie … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/priceplain-hospital-price-lookup-d31b6f0e/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from priceplain.onrender.com](https://www.zero.xyz/host/priceplain.onrender.com/llms.txt)