# FindMyDirectDoctor Clinic Access & Availability Directory

> FindMyDirectDoctor Clinic Access & Availability Directory 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).

Returns doctor offices near a US location showing whether they accept new patients, how to book, and what access features they offer (telehealth, home visits, hours, languages).

## Facts

- Endpoint: GET https://api.findmydirectdoctor.com/v1/clinics/access?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-clinic-access-availability-directory-6293ed23
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iEi_pJLDqUTLySH2OfII5

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-clinic-access-availability-directory-6293ed23
```

Example prompt: Find direct primary care or DPC doctor offices near ZIP 66210 in Kansas that are currently accepting new patients and offer telehealth, sorted by distance — show me up to 10 results with detailed booking info.

## When to prefer this

Use this endpoint when you need to find doctor offices by location with real-time acceptance status, booking method details, and access features like telehealth or extended hours. Prefer this over the price-stats or language-specific endpoints when the primary need is availability and access rather than cost comparison or language filtering alone. Best for patient-facing agents helping users find and book a new primary care doctor.

## Known failure modes

- Missing required location parameter (no zip, lat/lng, city+state, or state) returns a validation error
- Invalid ZIP format (not 5 digits) rejected by schema
- lat without lng or vice versa causes parameter error
- Stale data (>45 days) flagged in response but not excluded — agent must check stale flag
- Practice statements may be outdated or self-reported inaccurately — disclaimer always included
- next_cursor invalid or expired returns empty or error response
- Results limited to 25 per page; larger datasets require pagination

## How this service works

Whether doctor's offices near a place say they are taking new patients, how a patient can book (online scheduling, membership enrollment or request form), and whether they list telehealth, home visits, languages spoken, or Saturday, Sunday and evening hours. Filters combine. Each fact carries the date it was read and a stale flag after 45 days. Statements are the practice's own. Confirm before booking.

## Output

A paginated JSON list of matching practices, each with: acceptance status and wording, booking method(s) with URLs and kind labels, telehealth details, home visit info, hours text, languages, practice model, distance in miles, website, phone, and the date each fact was last checked plus a stale flag after 45 days. Also includes query echo, total_matches, next_cursor for pagination, and a disclaimer.

## 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; needs lng."
      },
      "lng": {
       "type": "number",
       "maximum": 180,
       "minimum": -180,
       "description": "Longitude; needs lat."
      },
      "zip": {
       "type": "string",
       "pattern": "^\\d{5}$",
       "description": "5-digit US ZIP code. Give zip, or lat with lng, or city with state, or state alone."
      },
      "city": {
       "type": "string",
       "maxLength": 80,
       "description": "City name; needs state."
      },
      "name": {
       "type": "string",
       "maxLength": 120,
       "description": "Practice name; needs state."
      },
      "open": {
       "enum": [
        "any",
        "saturday",
        "sunday",
        "evening",
        "weekend",
        "by_appointment"
       ],
       "type": "string",
       "default": "any",
       "description": "Only practices whose hours text shows this (parsed from the hours the practice published)."
      },
      "sort": {
       "enum": [
        "distance",
        "price"
       ],
       "type": "string",
       "default": "distance",
       "description": "distance = nearest first (by name for a state search). price = lowest adult monthly fee first, practices with no confirmed fee last."
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 25,
       "minimum": 1,
       "description": "Results per page, default 10, maximum 25."
      },
      "model": {
       "enum": [
        "dpc",
        "concierge",
        "membership",
        "cash_pay",
        "hybrid",
        "cash_specialist",
        "any"
       ],
       "type": "string",
       "default": "any",
       "description": "Practice model. cash_specialist means cash_pay. any includes unclear models."
      },
      "phone": {
       "type": "string",
       "maxLength": 30,
       "description": "Practice phone number."
      },
      "state": {
       "type": "string",
   
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "open": "any",
   "sort": "distance",
   "limit": 2,
   "model": "any",
   "scope": "ZIP 66210",
   "format": "concise",
   "booking": "any",
   "accepting": "accepting",
   "telehealth": true,
   "radius_miles": 25
  },
  "results": [
   {
    "zip": "66219",
    "city": "Lenexa",
    "name": "Thrive MD",
    "hours": {
     "note": "opening hours: not found in our data",
     "not_found": true,
     "hours_text": null
    },
    "model": "dpc",
    "phone": "(913) 600-4429",
    "state": "KS",
    "booking": [
     {
      "url": "https://www.thrivemdkc.com/services",
      "kind": "enroll_membership",
      "checked_on": "2026-09-25",
      "kind_label": "membership enrollment link",
      "online_booking": false,
      "practice_statement": "Pricing page with membership sign-up."
     }
    ],
    "website": "https://www.thrivemdkc.com/",
    "languages": {
     "note": "language statement: not found in our data",
     "languages": [],
     "not_found": true
    },
    "telehealth": {
     "modes": [],
     "states": [],
     "offered": true,
     "checked_on": "2026-09-25",
     "virtual_only": false,
     "practice_statement": "Telehealth may be available."
    },
    "home_visits": {
     "note": "home-visit statement: not found in our data",
     "offered": false,
     "not_found": true
    },
    "practice_id": "thrivemdkc.com",
    "distance_miles": 4.4,
    "location_precision": "street",
    "other_locations_count": 1,
    "accepting_new_patients": {
     "stale": false,
     "status": "accepting",
     "wording": "The practice states it is accepting new patients.",
     "applies_to": "practice",
     "checked_on": "2026-09-25",
     "practice_statement": "Site says it is accepting new members."
    }
   }
  ],
  "returned": 2,
  "data_as_of": "2026-10-02",
  "disclaimer": "Prices and statements are published by the practice on its own website. Confirm with the practice before booking. This is not medical, legal, tax or insurance advice.",
  "next_cursor": "bzoy",
  "source_note": "Facts read from each practice's own website",
  "total_matches": 3
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-clinic-access-availability-directory-6293ed23/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)
