{"uid":"cap_DszrUZtL0tMwqLQmEMFIA","slug":"hospital-billing-code-price-comparison-multi-hospital-b1ede79c","name":"Hospital Billing Code Price Comparison (Multi-Hospital)","description":"One billing code across up to 10 named hospitals, one normalized row each","url":"https://data.spencermcw.com/v1/hospital/compare?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"],"type":"string"},"queryParams":{"type":"object","required":["code","hospitals"],"properties":{"code":{"type":"string","pattern":"^[0-9A-Za-z]{3,5}$"},"plan":{"type":"string","maxLength":80,"minLength":2},"payer":{"type":"string","pattern":"^[a-z0-9_]{2,40}$"},"setting":{"enum":["inpatient","outpatient"],"type":"string"},"code_type":{"enum":["CPT","HCPCS","MS-DRG"],"type":"string"},"hospitals":{"type":"string","pattern":"^[A-Za-z0-9-]{6,20}(,[A-Za-z0-9-]{6,20}){0,9}$"},"plan_type":{"enum":["commercial","medicare_advantage","medicaid","medicare","exchange","tricare","va","workers_comp","auto","supplemental","other","unspecified"],"type":"string"},"billing_class":{"enum":["facility","professional"],"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","required":["code","filters","hospitals","not_found"],"properties":{"code":{"type":"object","required":["type","code","description","description_source","drg","mrfs_statewide"],"properties":{"drg":{"anyOf":[{"type":"object"},{"type":"null"}]},"code":{"type":"string"},"type":{"enum":["CPT","HCPCS","MS-DRG"],"type":"string"},"description":{"type":["string","null"]},"mrfs_statewide":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"description_source":{"anyOf":[{"enum":["cms_hcpcs_level_ii","cms_ms_drg"],"type":"string"},{"type":"null"}]}},"additionalProperties":false},"filters":{"type":"object","required":["payer","plan_type","plan","setting","billing_class"],"properties":{"plan":{"type":["string","null"]},"payer":{"type":["string","null"]},"setting":{"type":["string","null"]},"plan_type":{"type":["string","null"]},"billing_class":{"type":["string","null"]}},"additionalProperties":false},"hospitals":{"type":"array","items":{"type":"object","required":["id","ccn","name","city","status","priced","basis","mrfs","items","payers","gross","discounted_cash","negotiated_dollar","negotiated_percentage","deidentified_min","deidentified_max","confidence"],"properties":{"id":{"type":"string"},"ccn":{"type":["string","null"]},"city":{"type":["string","null"]},"mrfs":{"type":"array"},"name":{"type":"string"},"basis":{"anyOf":[{"enum":["unmodified","all"],"type":"string"},{"type":"null"}]},"gross":{"anyOf":[{"type":"object"},{"type":"null"}]},"items":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"payers":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"priced":{"type":"boolean"},"status":{"type":"string"},"confidence":{"type":["number","null"]},"discounted_cash":{"anyOf":[{"type":"object"},{"type":"null"}]},"deidentified_max":{"anyOf":[{"type":"string","pattern":"^\\d{1,12}(\\.\\d{1,6})?$"},{"type":"null"}]},"deidentified_min":{"anyOf":[{"type":"string","pattern":"^\\d{1,12}(\\.\\d{1,6})?$"},{"type":"null"}]},"negotiated_dollar":{"anyOf":[{"type":"object"},{"type":"null"}]},"negotiated_percentage":{"anyOf":[{"type":"object"},{"type":"null"}]}},"additionalProperties":false}},"not_found":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cXNFn_eAkqYpbwPLfYrtn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns normalized, side-by-side price rows for a single billing code across up to 10 named hospitals.","exampleAgentPrompt":"Compare what these six hospitals charge for CPT code 99213 under commercial insurance outpatient billing — use hospital IDs hospital-a, hospital-b, hospital-c, hospital-d, hospital-e, hospital-f and show me a normalized row for each.","exampleUseCases":[{"title":"Cheapest hospital for knee replacement","prompt":"I need to find which hospital charges the least for MS-DRG 470 (major joint replacement). Compare prices across these five hospitals: hosp-001, hosp-002, hosp-003, hosp-004, hosp-005 using medicare_advantage plan type and inpatient setting."},{"title":"Commercial rate shopping for colonoscopy","prompt":"Can you compare what these hospitals charge for CPT code 45378 (colonoscopy) under commercial insurance as an outpatient procedure? Check hospitals colonyctr-1, colonyctr-2, colonyctr-3, and memhospital-4."},{"title":"Employer benefits cost analysis","prompt":"Our HR team needs to compare negotiated facility rates for HCPCS code J0135 across these eight hospital systems for workers_comp plan type: sys-hosp-01, sys-hosp-02, sys-hosp-03, sys-hosp-04, sys-hosp-05, sys-hosp-06, sys-hosp-07, sys-hosp-08."}],"resultDescription":"Returns a structured object with: the resolved code metadata (type, description, DRG info, statewide MRF count), the filters applied (payer, plan type, plan name, setting, billing class), a list of hospitals not found in the dataset, and one normalized price row per matched hospital — allowing direct side-by-side comparison of negotiated rates.","failureModes":["Invalid billing code format (must match 3-5 alphanumeric pattern) — returns validation error","Hospital identifier not found in dataset — hospital appears in not_found list rather than results","Fewer than 1 or more than 10 hospital IDs provided — schema validation failure","Unknown code type for the given code — code metadata may have null description","No matching price data for specified payer/plan/setting filters — rows returned with null rates","Malformed hospital ID format — rejected by pattern validation before query executes"],"whenToPreferThis":"Use this endpoint when you need to compare prices for a single billing code across multiple specific, named hospitals simultaneously. It returns one normalized row per hospital, making it ideal for side-by-side cost comparison, benefits analysis, or price transparency research. Prefer this over the single-hospital or ZIP-based endpoints when you already know the hospital identifiers and need structured multi-institution output in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:40:43.411Z","isFirstParty":false,"canonicalSlug":"hospital-billing-code-price-comparison-multi-hospital-b1ede79c"}