# FindMyDirectDoctor Care Options Overview API

> FindMyDirectDoctor Care Options Overview API is a paid API for AI agents from api.findmydirectdoctor.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-31).

Returns the 3 lowest-cost DPC/cash-pay doctors, 3 nearest HRSA sliding-fee clinics, and (optionally) 3 lowest hospital cash prices for a named service — all near a given US location.

## Facts

- Endpoint: GET https://api.findmydirectdoctor.com/v1/care-options?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/findmydirectdoctor-care-options-overview-api-353e3ac1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WS27qsS-Q-CunR1sGietQ

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-care-options-overview-api-353e3ac1
```

Example prompt: I don't have insurance — can you find me the cheapest primary care doctors, any sliding-fee clinics, and the lowest hospital cash price for a brain MRI within 25 miles of ZIP code 66210?

## When to prefer this

Use this endpoint when you need a single-call, consolidated view of affordable care options across multiple provider types (DPC doctors, community health centers, and hospital cash prices) near a US location. It is ideal for uninsured or underinsured users seeking cost-conscious care and for agents that want to surface a ranked, plain-English summary without making separate calls to each provider type. Not suited for detailed doctor profiles, appointment booking, insurance billing lookups, or non-US locations.

## Known failure modes

- No providers found within the requested radius — try increasing radius_miles up to 100
- Invalid or unrecognized ZIP code returns a location resolution error
- Unknown service name may not match any CPT/HCPCS code in the hospital price library, returning no hospital_prices block
- lat/lng out of range or non-US location returns a validation error
- Missing required location parameter (no zip, no lat+lng, no city+state) returns a 400 error

## How this service works

One-call overview of lower-cost care options near a location: the 3 lowest-priced direct primary care (DPC) and cash-pay doctors, the 3 nearest HRSA health centers (sliding fee clinics), and, when a service is named, the 3 lowest posted hospital cash prices with the area median and financial assistance links. Includes a short plain options overview.

## Output

A JSON object containing: the interpreted query; a plain-language options overview; up to 3 DPC/cash-pay doctors with membership pricing; up to 3 HRSA community health centers with contact info, address, and distance; optionally up to 3 hospitals with the lowest cash price for the requested service including financial assistance URLs and area median price; data freshness date; attribution and disclaimer text.

## 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."
      },
      "state": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "2-letter US state code. Used together with city."
      },
      "service": {
       "type": "string",
       "maxLength": 120,
       "description": "Optional service in plain words, for example brain MRI. Adds the 3 lowest hospital cash prices, the area median and financial assistance links."
      },
      "radius_miles": {
       "type": "number",
       "default": 50,
       "maximum": 100,
       "description": "Search radius in miles (default 50, maximum 100). 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",
      "options_overview",
      "dpc_and_cash_pay_doctors",
      "health_centers",
      "data_as_of",
      "source"
     ],
     "properties": {
      "query": {
       "type": "object",
       "description": "The request as understood."
      },
      "source": {
       "type": "string"
      },
      "data_as_of": {
       "type": "string"
      },
      "disclaimer": {
       "type": "string"
      },
      "health_centers": {
       "type": "obje
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "service": "70551",
   "location": "ZIP 66210",
   "radius_miles": 25
  },
  "source": "FindMyDirectDoctor directory; HRSA Health Center Program (ODbL 1.0); FindMyDirectDoctor Foundation hospital cash price library",
  "data_as_of": "2026-10-02",
  "disclaimer": "Prices and availability change. Confirm directly with each provider before making care decisions.",
  "health_centers": {
   "license": "https://opendatacommons.org/licenses/odbl/1.0/",
   "results": [
    {
     "id": "BPS-LAL-035977",
     "zip": "66214",
     "city": "Overland Park",
     "name": "MTMM-Shawnee",
     "phone": "913-248-9965",
     "state": "KS",
     "address": "11644 W 75th St, Suite 103",
     "website": "https://www.mercyandtruth.com",
     "distance_miles": 4.7
    },
    {
     "id": "BPS-H80-018527",
     "zip": "66204",
     "city": "Overland Park",
     "name": "Health Partnership Clinic, Inc.",
     "phone": "913-432-3334",
     "state": "KS",
     "address": "9119 W 74th St, Ste 210",
     "website": "https://hpcjc.com",
     "distance_miles": 4.8
    },
    {
     "id": "BPS-H80-032440",
     "zip": "66062",
     "city": "Olathe",
     "name": "Health Partnership Clinic Olathe Suite 207",
     "phone": "913-648-2266",
     "state": "KS",
     "address": "407 S Clairborne Rd, Ste 207",
     "website": null,
     "distance_miles": 5.7
    }
   ],
   "attribution": "Source: HRSA Health Center Program, ODbL 1.0",
   "description": "The three nearest HRSA health centers (community clinics that set fees on a sliding scale by income). The HRSA data has no field for services offered, so a call to the center can confirm services and fees."
  },
  "hospital_prices": {
   "code": "70551",
   "category": "imaging",
   "cheapest": [
    {
     "ccn": "170146",
     "city": "Kansas City",
     "flag": "",
     "name": "Providence Medical Center",
     "state": "KS",
     "file_date": "2026-03-17",
     "cash_price_usd": 224,
     "distance_miles": 13.5,
     "financial_assistance": {
      "fap_url": "https://providencekc.com/financial-assistance/"
     }
    },
    {
     "ccn": "260085",
     "city": "Kansas City",
     "flag": "",
     "name": "St. Joseph Medical Center",
     "state": "MO",
     "file_date": "2026-03-17",
     "cash_price_usd": 237,
     "distance_miles": 6.1,
     "financial_assistance": {
      "fap_url": "https://stjosephkc.com/financial-assistance/"
     }
    },
    {
     "ccn": "260193",
     "city": "Blue
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-care-options-overview-api-353e3ac1/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)
