# FindMyDirectDoctor Hospital Self-Pay Price Statistics API

> FindMyDirectDoctor Hospital Self-Pay Price Statistics 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).

Returns statistical distribution of hospital self-pay (cash) prices for a given medical service in a US state or nationwide, including low, 25th percentile, median, 75th percentile, and high prices.

## Facts

- Endpoint: GET https://api.findmydirectdoctor.com/v1/hospital-prices/stats?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-self-pay-price-statistics-api-f16bdac1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vtq45QPPAaOAQxmENOorO

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-self-pay-price-statistics-api-f16bdac1
```

Example prompt: What are the hospital cash-pay price statistics for a brain MRI without contrast in Kansas — give me the low, median, and high posted prices along with how that compares to the national median?

## When to prefer this

Use this endpoint when you need statistical price distribution (not a single price quote) for a specific medical service across all hospitals in a state or nationally. Ideal for benchmarking a price quote, building cost transparency tools, or helping uninsured patients understand typical cash prices before seeking care. Prefer this over the nearby-hospitals endpoint when geographic proximity is not needed and you want aggregate statistics rather than individual facility prices.

## Known failure modes

- Ambiguous plain-word service name resolves to wrong code — response includes close alternatives for review
- Fewer than 5 hospital prices in a state causes median to return null
- Fewer than 10 prices causes P25/P75 to return null
- Invalid state code returns 400 error
- Both state and national=true provided simultaneously returns validation error
- Service or code not in supported 28-service catalog returns no-match error
- CPT/HCPCS code pattern mismatch (not 5 alphanumeric chars) returns schema validation error

## How this service works

Statistics of hospital self-pay (cash) prices for one service in a state or nationwide: number of hospitals, lowest, 25th percentile, median, 75th percentile and highest posted price, plus the national median. The service is a CPT or HCPCS code or plain words such as brain MRI. Built from prices hospitals post under the federal price transparency rule, read in October 2026. Facility portion only.

## Output

A JSON object containing the number of distinct hospital prices analyzed, statistical price distribution (low, P25, median, P75, high in USD), the resolved CPT/HCPCS code and service name, national benchmark statistics, hospital coverage counts for the requested scope, the data collection date, and a disclaimer about facility-only pricing.

## 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": {
      "code": {
       "type": "string",
       "pattern": "^[A-Za-z0-9]{5}$",
       "description": "CPT or HCPCS billing code of one of the 28 supported services, for example 70551 (brain MRI, no contrast). Give code or service, not both. GET /v1/hospital-prices/codes lists them."
      },
      "state": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "2-letter US state code (or DC). Give state or national=true, not both."
      },
      "service": {
       "type": "string",
       "maxLength": 120,
       "description": "The service in plain words, for example brain MRI without contrast. The free dictionary resolves it to a code, and the response shows the resolved code and close alternatives."
      },
      "national": {
       "type": "boolean",
       "description": "true for nationwide statistics. Give state or national=true, not both."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "n",
      "data_as_of",
      "disclaimer"
     ],
     "properties": {
      "n": {
       "type": "integer",
       "description": "Distinct hospital prices used."
      },
      "notes": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "query": {
       "type": "object",
       "description": "The request as understood."
      },
      "source": {
       "type": "string"
      },
      "low_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "p25_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "p75_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "high_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "n_posted": {
       "type": "integer"
      },
      "national": {
       "type": "ob
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "n": 86,
  "notes": [
   "n counts distinct hospital prices used (prices flagged unusual are left out, and hospitals that share one price file with the same price count once).",
   "A median needs 5 or more prices and a 25th to 75th percentile range needs 10 or more; otherwise those fields are null."
  ],
  "query": {
   "code": "70551",
   "scope": {
    "state": "KS"
   },
   "plain_name": "Brain MRI, no contrast"
  },
  "source": "FindMyDirectDoctor Foundation hospital cash price library (hospital price files posted under the federal price transparency rule, 45 CFR 180)",
  "low_usd": 224,
  "p25_usd": 874.11,
  "p75_usd": 1815.55,
  "high_usd": 13016.93,
  "n_posted": 88,
  "national": {
   "n": 3306,
   "p25_usd": 1120.8,
   "p75_usd": 2877.96,
   "median_usd": 1857.03
  },
  "data_as_of": "2026-10-02",
  "disclaimer": "Posted hospital self-pay prices for the facility portion only. Final bills can differ. Confirm with the hospital.",
  "median_usd": 1349.78,
  "resolved_code": {
   "code": "70551",
   "category": "imaging",
   "plain_name": "Brain MRI, no contrast"
  },
  "hospital_coverage": {
   "scope": "KS",
   "hospitals_covered": 134,
   "hospitals_with_posted_prices": 109
  },
  "n_hospitals_covered": 135,
  "national_median_usd": 1857.03,
  "price_rules_version": "1.8"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-hospital-self-pay-price-statistics-api-f16bdac1/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)