# FindMyDirectDoctor Hospital Cash Price Search > FindMyDirectDoctor Hospital Cash Price Search is a paid API for AI agents from api.findmydirectdoctor.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-31). 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. ## Facts - Endpoint: GET https://api.findmydirectdoctor.com/v1/hospital-prices/search?utm_source=zero.xyz - Price: $0.03/call - Payment: x402 - Status: unknown - Last checked: 2026-10-31 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/findmydirectdoctor-hospital-cash-price-search-c505a76e - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8IfGzTRPQ9XZZ0Pw3X6cZ Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability findmydirectdoctor-hospital-cash-price-search-c505a76e ``` Example prompt: 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? ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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. ## Output 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. ## Request schema (JSON Schema) ```json { "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 pla … (truncated) ``` ## Response schema (JSON Schema) ```json { "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 } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-hospital-cash-price-search-c505a76e/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.findmydirectdoctor.com](https://www.zero.xyz/host/api.findmydirectdoctor.com/llms.txt)