# FindMyDirectDoctor Hospital Financial Assistance Policy Finder > FindMyDirectDoctor Hospital Financial Assistance Policy Finder is a paid API for AI agents from api.findmydirectdoctor.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-31). Finds a hospital's financial assistance (charity care) policy link by CCN, name+state fuzzy match, or nearest location, along with state law notes and a plain-English 501(r) explainer. ## Facts - Endpoint: GET https://api.findmydirectdoctor.com/v1/hospitals/financial-assistance?utm_source=zero.xyz - Price: $0.02/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-financial-assistance-policy-finder-b903a324 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qvS6QIgFLWoMYNmvH8y-r 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-financial-assistance-policy-finder-b903a324 ``` Example prompt: Can you find the financial assistance or charity care policy page for the nearest hospitals to ZIP code 66210, within 25 miles? ## When to prefer this Use this endpoint when an agent or user needs to locate a hospital's official financial assistance or charity care policy page — especially for uninsured or underinsured patients navigating hospital bills. It excels at fuzzy name matching, CCN-based lookup for precise hospital identification, and proximity-based discovery. Prefer this over generic web search when you need a structured, verified result with link-check metadata and 501(r) context rather than raw search results. ## Known failure modes - No verified financial assistance link found for a hospital — fap_status returns 'no_link_found' - Invalid or unrecognized CCN returns empty results or error - Hospital name fuzzy match returns up to 5 candidates that may not include the intended hospital - Location outside the US or radius exceeds 150 miles returns error or no results - Stale or broken policy links — noted in link_notes field that ~20% are system-wide pages and links can go stale - Missing required parameter combination (e.g. name without state) returns validation error ## How this service works Finds a hospital's financial assistance (charity care) policy link by CMS certification number (CCN), by hospital name and state with fuzzy matching, or for the nearest hospitals to a location. Returns the hospital's own policy page or an explicit statement that no verified link was found, a state charity-care law note where one is on file, and a plain explanation of the federal rule (section 501(r)) that applies to nonprofit hospitals. ## Output An array of hospital results each containing the hospital name, address, CCN, city, state, ZIP, ownership type, a verified financial assistance policy URL (or explicit statement that none was found), the FAP link status, date the link was last checked, and distance in miles if searching by location. Also includes a plain-English explanation of the federal 501(r) rule, any applicable state charity-care law note, data freshness timestamp, and a disclaimer about confirming details with the hospital's billing office. ## 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": { "ccn": { "type": "string", "pattern": "^[0-9A-Za-z]{6}$", "description": "6-character CMS certification number (CCN) of the hospital. Use ccn, or name with state, or a location." }, "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." }, "name": { "type": "string", "maxLength": 100, "minLength": 2, "description": "Hospital name, matched loosely. Used together with state. Up to 5 candidates are returned." }, "limit": { "type": "integer", "default": 5, "maximum": 10, "minimum": 1, "description": "Results per page (default 5, maximum 10)." }, "state": { "type": "string", "pattern": "^[A-Za-z]{2}$", "description": "2-letter US state code. Used together with city." }, "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", "returned", "results", "explainer", "data_as_of", "disclaimer" … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "match": "nearest", "query": { "mode": "location", "location": "ZIP 66210", "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": "170185", "zip": "66213", "city": "Overland Park", "name": "Saint Luke's South Hospital", "state": "KS", "address": "12300 Metcalf Avenue", "fap_url": "https://www.saintlukeskc.org/patients-visitors/financial-assistance", "fap_status": "verified_link", "owner_type": "Voluntary non-profit - Other", "link_checked": "2026-10-16", "distance_miles": 1.9, "state_charity_care_law": null }, { "ccn": "170176", "zip": "66215", "city": "Overland Park", "name": "Overland Park Regional Medical Center", "state": "KS", "address": "10500 Quivira Road", "fap_url": "https://www.hcamidwest.com/patient-resources/patient-financial-resources/financial-assistance", "fap_status": "verified_link", "owner_type": "Proprietary", "link_checked": "2026-10-16", "distance_miles": 2.9, "state_charity_care_law": null } ], "returned": 2, "explainer": "Federal tax law (section 501(r) of the Internal Revenue Code) requires nonprofit hospitals (tax-exempt charity hospitals) to have a written financial assistance policy (also called charity care) and to share it with patients. Hospitals owned by governments or run for profit are not covered by that rule, although many offer help anyway. The link reported here is the hospital's own page and can go out of date, so the hospital's billing office can confirm the current policy and how to apply.", "data_as_of": "2026-10-02", "disclaimer": "Financial assistance rules and amounts differ by hospital and can change. Confirm with the hospital's billing office.", "link_notes": "A link is shown only when it was found on the hospital's own website and checked. About 20 percent of the links are system-wide pages rather than a page for one hospital. Links can go stale.", "with_verified_link": 2 } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-hospital-financial-assistance-policy-finder-b903a324/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)