# FindMyDirectDoctor Cash Service Price Statistics API

> FindMyDirectDoctor Cash Service Price Statistics API 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).

Returns statistical spread (lowest, quartiles, median, highest) of self-pay cash prices for a named medical service across doctor's offices in a state, city, or nationwide

## Facts

- Endpoint: GET https://api.findmydirectdoctor.com/v1/prices/cash-service-stats?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-cash-service-price-statistics-api-1117ea6f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i6C-kDyp6KhLVi8t8m2fT

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-cash-service-price-statistics-api-1117ea6f
```

Example prompt: What's the price spread for a new patient office visit at cash-pay practices in Texas — give me the lowest, median, and highest posted prices?

## When to prefer this

Use this endpoint when you need statistical benchmarks (not individual listings) of self-pay cash prices for medical services across multiple practices in a region. Ideal for price transparency research, uninsured patient cost guidance, benefits design, or building healthcare cost tools. Prefer this over individual practice lookups when you want market-level price intelligence — medians, quartiles, and ranges — filtered by state, city, ZIP, or coordinates, with optional breakdowns by practice model (DPC, cash-pay, concierge, etc.).

## Known failure modes

- Fewer than 5 practices found for the location/service combination — median returns null
- Fewer than 10 practices — quartiles return null
- Service name not recognized or matched — may return empty resolved services array
- Invalid state code or malformed ZIP — schema validation error
- Location parameters incomplete (e.g. city without state, lat without lng) — query rejected
- No published exact prices available for the service in the region — empty statistics

## How this service works

Spread of published self-pay (cash) prices for a named service across doctor's offices in a state, around a place or nationwide: lowest, median, quartiles and highest of each practice's lowest exact price, with the number of practices and a split by practice model. Medians need 5 practices and quartiles 10. These are posted prices, not what patients paid. Confirm with the practice before booking.

## Output

A JSON object containing: the statistical distribution of self-pay cash prices (low, p25, median, p75, high in USD) across qualifying practices, the number of practices included in statistics, a breakdown of the same stats by practice model (DPC, cash_pay, unknown, etc.), the resolved service label(s) matched from the query, the geographic scope and filters applied, a note on the basis for one-value-per-practice methodology, how many rows were excluded, and a data freshness date plus 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": [
      "service"
     ],
     "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."
      },
      "unit": {
       "enum": [
        "auto",
        "visit",
        "session",
        "unit",
        "vial",
        "15_min",
        "hour",
        "week",
        "month",
        "quarter",
        "year",
        "one_time",
        "item"
       ],
       "type": "string",
       "default": "auto",
       "description": "The unit compared. auto (default) = the most common unit."
      },
      "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."
      },
      "state": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "2-letter state code. Alone, it searches the whole state."
      },
      "service": {
       "type": "string",
       "maxLength": 100,
       "description": "The service, as a code or plain words. Codes include sports_physical, dot_physical, annual_physical, well_child, iv_therapy, weight_loss, glp1_medication, vaccines, lab_testing, ekg, imaging, telehealth_visit, home_visit, urgent_care, new_patient_visit, followup_visit, office_visit, primary_care, chronic_care, pediatrics, womens_health, mens_health, psychiatry_med_mgmt, mental_health_therapy, botox_fillers, skin_aesthet
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Counts are practices (not locations). Medians need 5 practices and quartiles 10; smaller samples show null. These are published prices, not what patients paid.",
  "unit": "visit",
  "basis": {
   "rule": "One value per practice: its lowest exact published price per visit. Starts-at, range, up-to and complex prices are left out.",
   "rows_left_out": 5,
   "practices_with_a_price": 70,
   "practices_in_statistics": 67
  },
  "query": {
   "unit": "visit",
   "model": "any",
   "scope": "TX",
   "service": [
    "new_patient_visit",
    "followup_visit",
    "office_visit"
   ],
   "audience": "standard"
  },
  "service": {
   "label": "New-patient visit; Follow-up visit; Office visit (type not stated)",
   "resolved": [
    "new_patient_visit",
    "followup_visit",
    "office_visit"
   ],
   "requested": "office visit"
  },
  "audience": "standard",
  "by_model": {
   "dpc": {
    "low_usd": 85,
    "p25_usd": null,
    "p75_usd": null,
    "high_usd": 450,
    "median_usd": 179,
    "n_practices": 7
   },
   "unknown": {
    "low_usd": 30,
    "p25_usd": 85,
    "p75_usd": 157.5,
    "high_usd": 650,
    "median_usd": 122.5,
    "n_practices": 34
   },
   "cash_pay": {
    "low_usd": 30,
    "p25_usd": 63.75,
    "p75_usd": 191.25,
    "high_usd": 750,
    "median_usd": 125,
    "n_practices": 18
   }
  },
  "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.",
  "statistics": {
   "low_usd": 30,
   "p25_usd": 85,
   "p75_usd": 200,
   "high_usd": 750,
   "median_usd": 150,
   "n_practices": 67
  },
  "source_note": "Facts read from each practice's own website"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-cash-service-price-statistics-api-1117ea6f/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)