{"uid":"cap_vtq45QPPAaOAQxmENOorO","slug":"findmydirectdoctor-hospital-self-pay-price-statistics-api-f16bdac1","name":"FindMyDirectDoctor Hospital Self-Pay Price Statistics API","description":"Statistics of hospital self-pay (cash) prices for one service in a state or nationwide: number of hospitals, lowest, 25th percentile, median, 75th percentile and highest posted price, plus the national median. The service is a CPT or HCPCS code or plain words such as brain MRI. Built from prices hospitals post under the federal price transparency rule, read in October 2026. Facility portion only.","url":"https://api.findmydirectdoctor.com/v1/hospital-prices/stats?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":[],"properties":{"code":{"type":"string","pattern":"^[A-Za-z0-9]{5}$","description":"CPT or HCPCS billing code of one of the 28 supported services, for example 70551 (brain MRI, no contrast). Give code or service, not both. GET /v1/hospital-prices/codes lists them."},"state":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"2-letter US state code (or DC). Give state or national=true, not both."},"service":{"type":"string","maxLength":120,"description":"The service in plain words, for example brain MRI without contrast. The free dictionary resolves it to a code, and the response shows the resolved code and close alternatives."},"national":{"type":"boolean","description":"true for nationwide statistics. Give state or national=true, not both."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","n","data_as_of","disclaimer"],"properties":{"n":{"type":"integer","description":"Distinct hospital prices used."},"notes":{"type":"array","items":{"type":"string"}},"query":{"type":"object","description":"The request as understood."},"source":{"type":"string"},"low_usd":{"type":["number","null"]},"p25_usd":{"type":["number","null"]},"p75_usd":{"type":["number","null"]},"high_usd":{"type":["number","null"]},"n_posted":{"type":"integer"},"national":{"type":"object","properties":{"n":{"type":"integer"},"p25_usd":{"type":["number","null"]},"p75_usd":{"type":["number","null"]},"median_usd":{"type":["number","null"]}}},"data_as_of":{"type":"string"},"disclaimer":{"type":"string","description":"Posted hospital self-pay prices for the facility portion only. Final bills can differ. Confirm with the hospital."},"median_usd":{"type":["number","null"]},"alternatives":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"score":{"type":"number"},"plain_name":{"type":"string"}}},"description":"Other codes that also fit the words, best first."},"resolved_code":{"type":"object","required":["code","plain_name"],"properties":{"code":{"type":"string"},"category":{"type":"string"},"plain_name":{"type":"string"}},"description":"The billing code the response is about."},"service_match":{"type":"object","properties":{"note":{"type":"string"},"query":{"type":"string"},"confidence":{"enum":["exact","close","best_guess"],"type":"string"},"matched_phrase":{"type":["string","null"]}},"description":"Present when service (plain words) was used: how the words were matched to a code."},"hospital_coverage":{"type":"object","description":"How many hospitals are in the price library and how many posted prices, for the scope of this response (counts only, no names)."},"n_hospitals_covered":{"type":"integer","description":"Hospitals in scope in the library."},"national_median_usd":{"type":["number","null"]},"price_rules_version":{"type":["string","null"],"description":"Version of the rules used to clean the price files."}}}}}}},"responseSchema":{"type":"json","example":{"n":86,"notes":["n counts distinct hospital prices used (prices flagged unusual are left out, and hospitals that share one price file with the same price count once).","A median needs 5 or more prices and a 25th to 75th percentile range needs 10 or more; otherwise those fields are null."],"query":{"code":"70551","scope":{"state":"KS"},"plain_name":"Brain MRI, no contrast"},"source":"FindMyDirectDoctor Foundation hospital cash price library (hospital price files posted under the federal price transparency rule, 45 CFR 180)","low_usd":224,"p25_usd":874.11,"p75_usd":1815.55,"high_usd":13016.93,"n_posted":88,"national":{"n":3306,"p25_usd":1120.8,"p75_usd":2877.96,"median_usd":1857.03},"data_as_of":"2026-10-02","disclaimer":"Posted hospital self-pay prices for the facility portion only. Final bills can differ. Confirm with the hospital.","median_usd":1349.78,"resolved_code":{"code":"70551","category":"imaging","plain_name":"Brain MRI, no contrast"},"hospital_coverage":{"scope":"KS","hospitals_covered":134,"hospitals_with_posted_prices":109},"n_hospitals_covered":135,"national_median_usd":1857.03,"price_rules_version":"1.8"}},"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_ZMph8Hkng0NQCSHtV-UVT","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 statistical distribution of hospital self-pay (cash) prices for a given medical service in a US state or nationwide, including low, 25th percentile, median, 75th percentile, and high prices.","exampleAgentPrompt":"What are the hospital cash-pay price statistics for a brain MRI without contrast in Kansas — give me the low, median, and high posted prices along with how that compares to the national median?","exampleUseCases":[{"title":"Uninsured patient budget planning","prompt":"I need surgery and don't have insurance — what are the hospital self-pay prices for CPT code 27447 (total knee replacement) in Colorado? Give me the range from lowest to highest and tell me where the median falls nationally."},{"title":"Healthcare cost comparison tool","prompt":"I'm building a cost transparency tool — can you pull the cash price statistics for a brain MRI without contrast in California and tell me how the state median compares to the national median?"},{"title":"Employer benefits benchmarking","prompt":"We're reviewing our employee health plan. What do hospitals nationwide typically charge self-pay patients for an outpatient colonoscopy? I want the 25th percentile, median, and 75th percentile prices."}],"resultDescription":"A JSON object containing the number of distinct hospital prices analyzed, statistical price distribution (low, P25, median, P75, high in USD), the resolved CPT/HCPCS code and service name, national benchmark statistics, hospital coverage counts for the requested scope, the data collection date, and a disclaimer about facility-only pricing.","failureModes":["Ambiguous plain-word service name resolves to wrong code — response includes close alternatives for review","Fewer than 5 hospital prices in a state causes median to return null","Fewer than 10 prices causes P25/P75 to return null","Invalid state code returns 400 error","Both state and national=true provided simultaneously returns validation error","Service or code not in supported 28-service catalog returns no-match error","CPT/HCPCS code pattern mismatch (not 5 alphanumeric chars) returns schema validation error"],"whenToPreferThis":"Use this endpoint when you need statistical price distribution (not a single price quote) for a specific medical service across all hospitals in a state or nationally. Ideal for benchmarking a price quote, building cost transparency tools, or helping uninsured patients understand typical cash prices before seeking care. Prefer this over the nearby-hospitals endpoint when geographic proximity is not needed and you want aggregate statistics rather than individual facility prices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:37.523Z","isFirstParty":false,"canonicalSlug":"findmydirectdoctor-hospital-self-pay-price-statistics-api-f16bdac1"}