{"uid":"cap_8IfGzTRPQ9XZZ0Pw3X6cZ","slug":"findmydirectdoctor-hospital-cash-price-search-c505a76e","name":"FindMyDirectDoctor Hospital Cash Price Search","description":"US hospital self-pay (cash) prices posted under the federal price transparency rule. Search 28 common services (imaging, blood tests, emergency room visit levels, EKG, colonoscopy) by CPT or HCPCS billing code or plain words, near a ZIP code, city and state, or latitude/longitude. Returns each hospital's posted cash price, distance, price file date, data flag and financial assistance (charity care) link, plus the area median. Facility portion only; final bills can differ.","url":"https://api.findmydirectdoctor.com/v1/hospital-prices/search?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":{"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."},"sort":{"enum":["price","distance"],"type":"string","default":"price","description":"price = lowest cash price first. distance = nearest first."},"limit":{"type":"integer","default":10,"maximum":25,"minimum":1,"description":"Results per page (default 10, maximum 25)."},"state":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"2-letter US state code. Used together with city."},"cursor":{"type":"string","description":"Opaque value from next_cursor of the previous response, to fetch the next page with the same other parameters."},"format":{"enum":["concise","detailed"],"type":"string","default":"concise","description":"concise = key fields. detailed = every field."},"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."},"radius_miles":{"type":"number","default":50,"maximum":150,"description":"Search radius in miles (default 50, maximum 150). A larger value is lowered to the maximum.","exclusiveMinimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","total_matches","returned","results","data_as_of","disclaimer"],"properties":{"query":{"type":"object","description":"The search as understood, with defaults applied."},"source":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"ccn":{"type":"string","description":"CMS certification number."},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]},"zip":{"type":"string"},"city":{"type":"string"},"code":{"type":"string"},"flag":{"type":"string","description":"Data flag. Empty when none. See flag_key."},"name":{"type":"string"},"state":{"type":"string"},"address":{"type":"string"},"fap_url":{"type":["string","null"],"description":"Verified financial assistance (charity care) page, or null."},"file_date":{"type":["string","null"],"description":"Date of the hospital's price file."},"owner_type":{"type":["string","null"]},"fap_checked":{"type":["string","null"]},"hospital_type":{"type":["string","null"]},"cash_price_usd":{"type":"number","description":"Posted self-pay (cash) price, facility portion only."},"distance_miles":{"type":["number","null"]},"price_file_url":{"type":["string","null"]}}}},"flag_key":{"type":"object","description":"Plain meaning of each flag that appears in results."},"returned":{"type":"integer"},"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."},"area_prices":{"type":"object","properties":{"note":{"type":"string"},"scope":{"type":"string"},"n_used":{"type":"integer","description":"Distinct hospital prices used (prices flagged unusual are left out)."},"low_usd":{"type":["number","null"]},"p25_usd":{"type":["number","null"],"description":"null when fewer than 10 prices."},"p75_usd":{"type":["number","null"],"description":"null when fewer than 10 prices."},"high_usd":{"type":["number","null"]},"n_posted":{"type":"integer"},"median_usd":{"type":["number","null"],"description":"null when fewer than 5 prices."},"unusual_left_out":{"type":"integer"}},"description":"Cash-price statistics for the hospitals in the area."},"next_cursor":{"type":["string","null"],"description":"Pass as cursor for the next page. null on the last page."},"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."},"total_matches":{"type":"integer","description":"Hospitals inside the radius with a posted price for the code."},"state_median_usd":{"type":"object","properties":{"state":{"type":"string"},"n_used":{"type":"integer"},"median_usd":{"type":["number","null"]}},"description":"Median posted cash price in the state of the nearest priced hospital."},"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)."},"price_files_newest":{"type":["string","null"],"description":"Newest price file date in the data for this code."},"national_median_usd":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"query":{"code":"70551","sort":"price","limit":2,"format":"concise","location":"ZIP 66210","plain_name":"Brain MRI, no contrast","radius_miles":25},"source":"FindMyDirectDoctor Foundation hospital cash price library (hospital price files posted under the federal price transparency rule, 45 CFR 180)","results":[{"ccn":"170146","city":"Kansas City","flag":"","name":"Providence Medical Center","state":"KS","fap_url":"https://providencekc.com/financial-assistance/","file_date":"2026-03-17","cash_price_usd":224,"distance_miles":13.5},{"ccn":"260085","city":"Kansas City","flag":"","name":"St. Joseph Medical Center","state":"MO","fap_url":"https://stjosephkc.com/financial-assistance/","file_date":"2026-03-17","cash_price_usd":237,"distance_miles":6.1}],"flag_key":{},"returned":2,"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.","area_prices":{"note":"A median needs 5 or more distinct hospital prices and a 25th to 75th percentile range needs 10 or more; otherwise those fields are null. Prices flagged unusual are left out.","scope":"hospitals within 25 miles","n_used":18,"low_usd":224,"p25_usd":548.23,"p75_usd":4233.83,"high_usd":13016.93,"n_posted":19,"median_usd":3152.4,"unusual_left_out":1},"next_cursor":"bzoy","resolved_code":{"code":"70551","category":"imaging","plain_name":"Brain MRI, no contrast"},"total_matches":19,"state_median_usd":{"state":"KS","n_used":86,"median_usd":1349.78},"hospital_coverage":{"scope":"hospitals within 25 miles","hospitals_covered":27,"hospitals_by_category":{"lab":19,"imaging":20,"heart_test":21,"colonoscopy":10,"emergency_room":20},"hospitals_with_posted_prices":23,"services_with_at_least_one_price":28,"nearest_hospital_with_prices_miles":1.9},"price_files_newest":"2026-10-24","national_median_usd":1857.03}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_woJvd-0s2OwAZcHISJWT2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search US hospital self-pay (cash) prices for 28 common services near a given location, returning each hospital's posted price, distance, and financial assistance link along with area statistics.","exampleAgentPrompt":"What are the cheapest cash prices for a brain MRI (no contrast) at hospitals within 25 miles of ZIP 66210 — show me the top 10 sorted by price and include any financial assistance links?","exampleUseCases":[{"title":"Uninsured patient comparing MRI costs","prompt":"I don't have insurance and need an MRI of my brain without contrast — can you find the hospitals within 30 miles of ZIP 90210 with the lowest self-pay cash prices and show me their financial assistance pages?"},{"title":"ER visit cost comparison by city","prompt":"What do hospitals in Austin, TX charge for a Level 3 emergency room visit if you pay cash? Sort by price and show me the area median so I know if a price is reasonable."},{"title":"Employer shopping lab test costs for staff","prompt":"We're helping employees find affordable blood work — can you search hospital cash prices for a basic metabolic panel near ZIP 30301 in Atlanta and return the 25 closest hospitals sorted by distance?"}],"resultDescription":"A JSON object containing: a list of matching hospitals (name, city, state, CCN, cash price in USD, distance in miles, price file date, financial assistance URL, and any data quality flags); area price statistics (median, 25th/75th percentile, low, high, n hospitals used); state and national medians; the resolved CPT/HCPCS code and plain name; hospital coverage counts by service category; and pagination cursor for the next page.","failureModes":["No location provided (zip, lat/lng, or city+state required) — returns validation error","Unsupported CPT/HCPCS code or unresolvable plain-language service name — returns error or empty results","Fewer than 5 hospitals with prices in area — area median and percentile fields return null","Location returns zero hospitals with posted prices in radius — empty results array","Invalid ZIP code format or out-of-range lat/lng — returns schema validation error","Cursor from a different parameter set used for pagination — may return unexpected results"],"whenToPreferThis":"Use this endpoint when you need federally mandated hospital self-pay (cash) price data for common services in the US, especially for comparing costs across nearby hospitals for a specific CPT/HCPCS code or plain-language service. Prefer this over general web search when you need structured, comparable price data with distance, area medians, and financial assistance links. Not suitable for insured/negotiated rate lookups, physician/clinic pricing, pharmacy costs, or services outside the 28 supported codes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:09.499Z","isFirstParty":false,"canonicalSlug":"findmydirectdoctor-hospital-cash-price-search-c505a76e"}