# FindMyDirectDoctor Colonoscopy Price Estimate API

> FindMyDirectDoctor Colonoscopy Price Estimate 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 posted hospital cash prices and Medicare 2026 benchmark amounts for four colonoscopy procedure codes near a given US location, with area medians and plain-language explanations.

## Facts

- Endpoint: GET https://api.findmydirectdoctor.com/v1/colonoscopy/estimate?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-colonoscopy-price-estimate-api-224afeb8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IiPRzQnsAh_5lWOmwgs9f

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-colonoscopy-price-estimate-api-224afeb8
```

Example prompt: Can you look up the posted hospital cash prices for a colonoscopy near ZIP 66210 within 25 miles, sorted by price, and show me how those compare to what Medicare pays at a surgery center versus a hospital outpatient department?

## When to prefer this

Use this endpoint when you need hospital-posted cash prices specifically for colonoscopy procedures at a US location, including Medicare 2026 benchmark comparisons between surgery centers and hospital outpatient departments. It is preferable to general hospital price lookup tools because it covers all four colonoscopy CPT/HCPCS codes, provides area medians, and breaks the Medicare allowed amount into facility, physician, anesthesia, and lab components with plain-language explanations. Choose this over a generic price comparison tool when the user explicitly needs colonoscopy-specific pricing transparency data, is uninsured or self-pay, or is comparing care settings (ASC vs HOPD).

## Known failure modes

- No hospitals found within the specified radius — try increasing radius_miles
- Invalid ZIP code format (must be exactly 5 digits)
- Invalid lat/lng combination outside US bounds
- Missing location parameter — must provide zip, lat+lng, or city+state
- Ambiguous city name without state — state is required with city
- radius_miles exceeds 150 — silently capped at maximum
- limit exceeds 10 — silently capped at maximum
- Payment not processed (x402 micropayment required at $0.03 USDC per call)

## How this service works

Colonoscopy price estimate near a location: posted hospital cash prices for four colonoscopy codes (diagnostic, with biopsy, with polyp removal, screening) with area medians, plus the Medicare 2026 allowed amounts at an ambulatory surgery center (surgery center) versus a hospital outpatient department for that ZIP, split into facility, doctor, anesthesia and lab. Plain explanations included. Reference prices, not quotes.

## Output

A JSON object containing: the interpreted query parameters; a list of up to 'limit' hospitals per colonoscopy CPT code (45378 diagnostic, 45380 with biopsy, 45385 with polyp removal, G0121 screening) with facility cash price, hospital name, city, state, distance in miles, file date, and financial assistance URL; area price statistics (low, P25, median, P75, high, n used); national median; Medicare 2026 ASC and HOPD allowed amounts broken into facility, physician, anesthesia, and lab components; plain-language explanations of the billing structure; data vintage date; and a disclaimer that prices are facility-only estimates, not quotes.

## 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."
      },
      "sort": {
       "enum": [
        "price",
        "distance"
       ],
       "type": "string",
       "default": "price",
       "description": "How the hospitals under each code are ordered."
      },
      "limit": {
       "type": "integer",
       "default": 3,
       "maximum": 10,
       "minimum": 1,
       "description": "Results per page (default 3, maximum 10)."
      },
      "state": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "2-letter US state code. Used together with city."
      },
      "radius_miles": {
       "type": "number",
       "default": 50,
       "maximum": 150,
       "description": "Search radius in miles (default 50, maximum 150). 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",
      "hospital_cash_prices",
      "medicare_2026_benchmark",
      "explanations",
      "data_as_of",
      "disclaimer"
     ],
     "properties": {
      "query": {
       "type": "object",
       "description": "The request as understood."
      },
      "source": {
       "type": "string"
      },
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "sort": "price",
   "limit": 1,
   "location": "ZIP 66210",
   "radius_miles": 25
  },
  "source": "FindMyDirectDoctor Foundation hospital cash price library (hospital price files posted under the federal price transparency rule, 45 CFR 180); CMS 2026 Physician Fee Schedule, ASC and OPPS payment files",
  "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.",
  "explanations": [
   "A colonoscopy has several separate bills: the facility (hospital or surgery center), the doctor, the anesthesia provider and, if tissue is taken, the lab. Hospital cash prices in this response cover the hospital's facility part only.",
   "Hospital cash prices in this response cover the hospital's facility part only, so they compare with the Facility row, not with the Total row.",
   "Prices flagged unusual are kept in the list and left out of the area median."
  ],
  "hospital_cash_prices": [
   {
    "code": "45378",
    "meaning": "a diagnostic colonoscopy (looking only, nothing taken or removed)",
    "category": "colonoscopy",
    "hospitals": [
     {
      "ccn": "170049",
      "city": "Olathe",
      "flag": "case_rate_only",
      "name": "University of Kansas Health System Olathe Hospital",
      "state": "KS",
      "fap_url": "https://www.kansashealthsystem.com/patient-visitor/financial/financial-assistance",
      "file_date": "2026-04-08",
      "cash_price_usd": 764.71,
      "distance_miles": 9.7
     }
    ],
    "plain_name": "Diagnostic colonoscopy (looking only)",
    "area_prices": {
     "n_used": 10,
     "low_usd": 764.71,
     "p25_usd": 926,
     "p75_usd": 4046.96,
     "high_usd": 4512.93,
     "median_usd": 1578.48
    },
    "national_median_usd": 1849.5,
    "hospitals_with_price": 10
   },
   {
    "code": "45380",
    "meaning": "a colonoscopy with a biopsy (a small tissue sample)",
    "category": "colonoscopy",
    "hospitals": [
     {
      "ccn": "170146",
      "city": "Kansas City",
      "flag": "",
      "name": "Providence Medical Center",
      "state": "KS",
      "fap_url": "https://providencekc.com/financial-assistance/",
      "file_date": "2026-03-17",
      "cash_price_usd": 1127,
      "distance_miles": 13.5
     }
    ],
    "plain_name": "Colonoscopy with a biopsy",
    "area_prices": {
     "n_used": 10,
     "low_usd": 1127,
     "p25_usd": 1201.24,
     "p75_usd": 5807.
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-colonoscopy-price-estimate-api-224afeb8/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)