# FindMyDirectDoctor Doctor Search API

> FindMyDirectDoctor Doctor Search API 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).

Search a directory of ~9,000 US direct primary care, concierge, and cash-pay doctors by location with price and filter options

## Facts

- Endpoint: GET https://api.findmydirectdoctor.com/v1/doctors/search?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-doctor-search-api-4ddce52f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WUDYO499FwhIY6qlqkSCQ

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-doctor-search-api-4ddce52f
```

Example prompt: Find me direct primary care doctors within 20 miles of ZIP code 78701 in Austin who offer telehealth, speak Spanish, and charge no more than $100 a month — sort by price and show me the top 10.

## When to prefer this

Use this endpoint when you need to find US direct primary care, concierge, or cash-pay doctors with transparent published monthly membership prices. It is the right choice when filtering by price cap, language, telehealth, home visits, practice model, or location radius. Prefer this over general physician directories when the user cares specifically about DPC or cash-pay pricing and membership-based primary care models rather than insurance-billed providers.

## Known failure modes

- Missing or invalid location parameter (no zip, lat/lng, or city+state) returns a 400 error
- Invalid ZIP code format (not 5 digits) returns a validation error
- City name not found in directory returns zero results
- limit exceeds maximum of 25 returns an error
- Invalid cursor token returns a 400 or empty result
- No doctors matching filters in the radius returns count 0 and empty results array
- Network timeout or service unavailability returns 5xx error

## How this service works

US direct primary care (DPC), concierge and cash-pay doctor directory with published adult monthly membership prices. Search by ZIP code, city and state, or latitude/longitude within a radius. Filter by language, telehealth, home visits, accepting new patients, specialty, credential, board certification, practice model and maximum monthly price. Returns practice, clinician, address, phone, website, fee and insurance stance. 8,976 US clinicians, verified October 2026.

## Output

Returns a paginated list of matching clinician records with practice name, clinician name, city, state, phone, website, practice model, distance in miles, and monthly fee in USD. Also includes total match count, priced match count, data freshness date, pagination cursor for next page, and a disclaimer to confirm details with the practice directly.

## 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",
     "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; resolves only for cities that have listed practices."
      },
      "sort": {
       "enum": [
        "distance",
        "price"
       ],
       "type": "string",
       "default": "distance",
       "description": "distance = nearest first. price = lowest monthly fee first, practices without a monthly fee last, ties by distance."
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 25,
       "minimum": 1,
       "description": "Results per page (maximum 25)."
      },
      "model": {
       "enum": [
        "dpc",
        "concierge",
        "cash_specialist",
        "any"
       ],
       "type": "string",
       "default": "any",
       "description": "Practice model: dpc, concierge, cash_specialist or any."
      },
      "state": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "2-letter US state code."
      },
      "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 = 10 key fields per result. detailed = every field."
      },
      "language": {
       "type": "string",
       "maxLength": 40,
     
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "query": {
   "sort": "price",
   "limit": 2,
   "model": "dpc",
   "format": "concise",
   "location": "ZIP 66210",
   "radius_miles": 25,
   "max_monthly_fee": 150
  },
  "source": "FindMyDirectDoctor directory",
  "results": [
   {
    "id": "fdd-N04023",
    "city": "Overland Park",
    "name": "Charles Sullivan",
    "model": "dpc",
    "phone": "(913) 261-9380",
    "state": "KS",
    "website": "https://www.oakhv.com/",
    "practice_name": "Oakhaven Health",
    "distance_miles": 2.6,
    "monthly_fee_usd": 60
   },
   {
    "id": "fdd-N04024",
    "city": "Overland Park",
    "name": "Staci Jordan",
    "model": "dpc",
    "phone": "(913) 261-9380",
    "state": "KS",
    "website": "https://www.oakhv.com/",
    "practice_name": "Oakhaven Health",
    "distance_miles": 2.6,
    "monthly_fee_usd": 60
   }
  ],
  "returned": 2,
  "data_as_of": "2026-10-02",
  "disclaimer": "Prices and availability change. Confirm directly with the practice before making care decisions.",
  "next_cursor": "bzoy",
  "total_matches": 13,
  "priced_matches": 13
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-doctor-search-api-4ddce52f/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)