{"uid":"cap_zz-nCtEWKJ5UQH7tEVMZw","slug":"findmydirectdoctor-hospital-price-comparison-api-7a29a3b8","name":"FindMyDirectDoctor Hospital Price Comparison API","description":"Compares a price quote for a hospital service with hospital cash prices posted within 50 miles of a ZIP code, falling back to the state. Returns the percentile of the quote, the local median and range, a neutral label (below typical, typical, above typical, far above typical) and plain next steps such as asking for an itemized bill, asking about a self-pay discount and financial assistance (charity care) links. Not legal or medical advice.","url":"https://api.findmydirectdoctor.com/v1/hospital-prices/check?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":["quoted_price"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude in decimal degrees. Used together with lng."},"lng":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude in decimal degrees. Used together with lat."},"zip":{"type":"string","pattern":"^\\d{5}$","description":"5-digit US ZIP code. A location is given as zip, or lat with lng, or city with state."},"city":{"type":"string","maxLength":80,"description":"City name. Used together with state."},"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. Used together with city."},"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."},"quoted_price":{"type":"number","maximum":10000000,"description":"The price quoted for the service, in US dollars.","exclusiveMinimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","label","percentile","comparison","next_steps","data_as_of","disclaimer"],"properties":{"label":{"enum":["below_typical","typical","above_typical","far_above_typical"],"type":"string"},"query":{"type":"object","description":"The request as understood."},"limits":{"type":"string"},"source":{"type":"string"},"cutoffs":{"type":"string"},"comparison":{"type":"object","properties":{"basis":{"enum":["within_50_miles","state"],"type":"string"},"scope":{"type":"string"},"n_used":{"type":"integer"},"low_usd":{"type":["number","null"]},"p25_usd":{"type":["number","null"]},"p75_usd":{"type":["number","null"]},"p90_usd":{"type":["number","null"]},"high_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."},"label_text":{"type":"string"},"next_steps":{"type":"array","items":{"type":"string"},"description":"Plain next steps. They are not legal advice."},"percentile":{"type":["number","null"],"description":"Share of posted cash prices (0 to 100) that the quote is higher than."},"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."},"percentile_text":{"type":"string"},"national_median_usd":{"type":["number","null"]},"financial_assistance_note":{"type":"string"},"financial_assistance_links":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string"},"name":{"type":"string"},"state":{"type":"string"},"distance_miles":{"type":["number","null"]},"financial_assistance":{"type":"object","properties":{"fap_url":{"type":["string","null"],"description":"The hospital's own financial assistance (charity care) page, or null when no verified link was found."},"fap_message":{"type":"string"}}}}}}}}}}}},"responseSchema":{"type":"json","example":{"label":"typical","query":{"code":"70551","location":"ZIP 66210","plain_name":"Brain MRI, no contrast","quoted_price_usd":2500},"limits":"The comparison uses posted cash prices for the hospital's facility portion only. A quote can include other items, so a difference in price does not by itself say anything about whether a bill is correct. This is not legal or medical advice.","source":"FindMyDirectDoctor Foundation hospital cash price library (hospital price files posted under the federal price transparency rule, 45 CFR 180)","cutoffs":"below_typical: under the 25th percentile. typical: 25th to 75th percentile. above_typical: above the 75th up to the 90th percentile. far_above_typical: above the 90th percentile.","comparison":{"basis":"within_50_miles","scope":"hospitals within 50 miles of ZIP 66210","n_used":26,"low_usd":224,"p25_usd":548.23,"p75_usd":4159.29,"p90_usd":10267.34,"high_usd":13016.93,"median_usd":2483.7},"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.","label_text":"The quoted price is within the middle range of the posted cash prices in the comparison area.","next_steps":["Ask the hospital for an itemized bill (a list of every charge with its billing code). It shows exactly what the quoted price covers.","Ask whether a self-pay discount (the cash price for patients who do not use insurance) applies to this service.","Ask about financial assistance (charity care). The nearest hospitals' financial assistance pages are listed under financial_assistance_links.","Ask whether the quote covers only the hospital's facility part or also the doctor, radiologist and anesthesia bills, which are often separate."],"percentile":50,"resolved_code":{"code":"70551","category":"imaging","plain_name":"Brain MRI, no contrast"},"percentile_text":"The quoted price is higher than about 50 of every 100 posted cash prices in the comparison.","national_median_usd":1857.03,"financial_assistance_links":[{"city":"Overland Park","name":"Saint Luke's South Hospital","state":"KS","distance_miles":1.9,"financial_assistance":{"fap_url":"https://www.saintlukeskc.org/patients-visitors/financial-assistance"}},{"city":"Overland Park","name":"Overland Park Regional Medical Center","state":"KS","distance_miles":2.9,"financial_assistance":{"fap_url":"https://www.hcamidwest.com/patient-resources/patient-financial-resources/financial-assistance"}},{"city":"Leawood","name":"Ascentist Hospital","state":"KS","distance_miles":3.7,"financial_assistance":{"status":"No verified link found. The hospital's billing office can say whether it has a financial assistance (charity care) policy.","fap_url":null}}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9pktTXV06VMONNcV7CYw2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares a quoted hospital service price against posted cash prices within 50 miles of a location, returning a percentile rank, local median/range, a plain-language label, and actionable next steps.","exampleAgentPrompt":"I just got a quote of $3,200 for a knee MRI with contrast (CPT 73721) from a hospital near ZIP 90210 — can you check whether that price is typical, high, or low compared to what other hospitals in that area post as their cash prices, and tell me what I should do next?","exampleUseCases":[{"title":"Validating a surprise ER bill","prompt":"I got a bill for $8,500 for an abdominal CT scan after an ER visit at a hospital near ZIP 77001 in Houston — can you check if that's a typical cash price for that service in the area or if it's way above average?"},{"title":"Pre-procedure cost comparison","prompt":"I'm scheduled for a brain MRI without contrast (code 70551) next month and the hospital quoted me $1,800. I'm in Chicago, ZIP 60601 — is that a reasonable price compared to other hospitals nearby, and what questions should I ask?"},{"title":"Uninsured patient negotiation prep","prompt":"I don't have insurance and was quoted $4,000 for a colonoscopy at a hospital near ZIP 30301 in Atlanta. Can you tell me what percentile that falls at compared to local hospital cash prices and what I should say to get a better deal?"}],"resultDescription":"Returns a JSON object containing the interpreted query (resolved billing code, location, quoted price), a label (below_typical, typical, above_typical, or far_above_typical), percentile rank among comparable hospitals, comparison statistics (median, P25, P75, P90, low, high, number of hospitals used), the geographic basis of the comparison (within 50 miles or state fallback), plain-language label text, percentile text, actionable next steps (itemized bill request, self-pay discount inquiry, charity care links), data freshness date, source attribution, and a disclaimer.","failureModes":["No hospitals found within 50 miles or the state for the given location — comparison basis falls back to state or returns insufficient data","Unrecognized service name — free-text resolution fails to map to a supported CPT/HCPCS code","Invalid ZIP code or coordinates outside the US — location validation error","Both code and service provided simultaneously — schema validation rejects the request","Quoted price of zero or negative — excluded by exclusiveMinimum constraint","Billing code not in the 28 supported codes — returns error or empty comparison set"],"whenToPreferThis":"Choose this endpoint when you need to contextualize a specific hospital price quote against real, federally-mandated posted cash prices from nearby hospitals — particularly for uninsured or self-pay patients, those negotiating bills, or anyone trying to understand whether a price is fair before or after a procedure. It is purpose-built for the 28 most common hospital services covered by federal price transparency rules and gives actionable consumer guidance, not just raw data. Prefer this over general cost-estimator tools when location-specific percentile benchmarking and next-step guidance (charity care links, self-pay discount prompts) are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:38:53.189Z","isFirstParty":false,"canonicalSlug":"findmydirectdoctor-hospital-price-comparison-api-7a29a3b8"}