{"uid":"cap_aXBBCcYJRehgEQOVjWPCx","slug":"hospital-procedure-price-lookup-mrf-2cddf701","name":"Hospital Procedure Price Lookup (MRF)","description":"Negotiated, gross and cash prices a hospital publishes for a procedure code, plus fused CMS Care Compare quality. Streams the slice of the hospital's own machine-readable file for one billing code and cites the file's hospital name, date and version. Informational, not a quote.","url":"https://api.agentstools.dev/price/hospital","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["code"],"properties":{"ccn":{"type":"string","description":"Optional 6-digit CMS Certification Number to fuse Care Compare quality"},"code":{"type":"string","description":"Procedure billing code to look up, e.g. 27447"},"payer":{"type":"string","description":"Optional payer or plan name substring to filter the returned negotiated rates"},"domain":{"type":"string","description":"Hospital domain to auto-discover the MRF instead of mrf_url"},"mrf_url":{"type":"string","description":"The hospital machine-readable-file URL (from /price/discover)"},"code_type":{"type":"array","items":{"enum":["CPT","HCPCS","MS-DRG","DRG","APC","NDC","ICD-10","CDM","local"],"type":"string"},"description":"Optional billing-code system(s) to constrain the match"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SVSgaNdSBUdYr4bEHc0PT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves negotiated, gross, and cash prices a hospital publishes for a given procedure billing code from the hospital's machine-readable file, optionally fused with CMS Care Compare quality data.","exampleAgentPrompt":"What are the negotiated and cash prices for CPT code 27447 (total knee replacement) at Mass General Hospital? Use their hospital domain massgeneral.org and also pull in the CMS Care Compare quality info using CCN 220071.","exampleUseCases":null,"resultDescription":"A JSON slice of the hospital's machine-readable file for the requested billing code, including negotiated rates per payer/plan, gross charges, cash/discounted prices, hospital name, MRF date and version, and optionally fused CMS Care Compare quality metrics. Response is informational and not a patient-specific insurance quote.","failureModes":["Billing code not found in the hospital's MRF — returns empty results or 404","Hospital domain does not publish a discoverable MRF — discovery fails","MRF file is very large and streaming times out","CCN does not match any CMS Care Compare entry — quality data absent","Payer filter substring matches no plans — empty negotiated rates returned","Invalid or unsupported billing code type — schema validation error"],"whenToPreferThis":"Use this endpoint when you need to retrieve actual hospital-published price transparency data for a specific billing code from a hospital's CMS-required machine-readable file. Prefer this over generic healthcare cost estimators when you need cited, primary-source pricing data with payer-level negotiated rates. It is especially useful when you already have or can discover the hospital's MRF URL (e.g., via /price/discover sibling endpoint) and want granular data for a single billing code.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:58:36.424Z","isFirstParty":false}