# FindMyDirectDoctor Care Cost Lookup API

> FindMyDirectDoctor Care Cost Lookup 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 cash and self-pay price data for a specific type of medical care — including price points, basis, source links, price drivers, and lower-cost alternatives — from physician-reviewed Foundation guides

## Facts

- Endpoint: GET https://api.findmydirectdoctor.com/v1/costs/care?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-care-cost-lookup-api-c19e2baa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y8yJFMMQc_SjN-QAMEF5R

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-care-cost-lookup-api-c19e2baa
```

Example prompt: What's the cash pay price for a colonoscopy without insurance? Pull the cost breakdown from FindMyDirectDoctor including price range, what the price is based on, and any tips for getting a lower quote.

## When to prefer this

Use this endpoint when you need structured, sourced, physician-reviewed cash and self-pay price data for a specific medical care type in the US — especially when the user is uninsured, underinsured, or comparing direct-pay options. Prefer this over generic web search when you need cited price ranges with explicit basis labels (posted price, Medicare rate, study figure) and actionable cost-reduction tips. Best for the 61 care types covered in the Foundation guides.

## Known failure modes

- No matching guide found for the topic — returns empty or error if the care type is not in the 61 published guides
- Ambiguous topic string that matches multiple guides — may return unexpected guide
- Missing required 'topic' query parameter — returns 400 or validation error
- Guide data may be outdated if last_reviewed date is old
- Price points may be null or missing for some care types where only qualitative information is available

## How this service works

Cash and self-pay prices for everyday care without insurance, such as a doctor visit, CT scan, colonoscopy, birth control, a surgery, a medical device or a vaccine, from 61 published Foundation guides. Every price figure keeps its quoted sentence, its basis (Medicare payment, posted clinic price, study figure) and its source link, plus price drivers, lower-cost routes and questions for getting a quote. Physician-reviewed, FindMyDirectDoctor Foundation.

## Output

Returns a structured response including: a quick_answer summarizing the typical cash price, one or more price_points with USD amounts, the basis of each price (e.g. Medicare payment, posted clinic price, study figure), the source URL, relevant quoted facts, steps or tips for getting a lower price, related guides, and a disclaimer. All data is physician-reviewed and sourced from FindMyDirectDoctor Foundation guides.

## 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": [
      "topic"
     ],
     "properties": {
      "topic": {
       "type": "string",
       "maxLength": 120,
       "minLength": 1,
       "description": "The care, as a guide slug (ekg-cost-without-insurance), a short name (colonoscopy, flu shot) or plain words. GET /v1/guides/index lists the guides."
      },
      "category": {
       "enum": [
        "service",
        "device",
        "procedure",
        "vaccine"
       ],
       "type": "string",
       "description": "Only look among this kind of guide. Leave out to search all four."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "guide_url",
      "last_reviewed",
      "quick_answer",
      "price_points",
      "credit",
      "data_as_of"
     ],
     "properties": {
      "facts": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "quote": {
          "type": "string"
         },
         "section": {
          "type": "string"
         },
         "source_url": {
          "type": [
           "string",
           "null"
          ]
         }
        }
       }
      },
      "group": {
       "type": "string"
      },
      "guide": {
       "type": "object",
       "required": [
        "slug",
        "title",
        "url",
        "last_reviewed"
       ],
       "properties": {
        "url": {
         "type": "string"
        },
        "slug": {
         "type": "string"
        },
        "title": {
         "type": "string"
        },
        "last_reviewed": {
         "type": "string"
        }
       },
       "description": "The guide the answer comes from."
      },
      "query": {
       "type": "object",
       "description": "The request as understood, with the guide it matched."
      },
      "steps": {
       "type": "array",
       "items": {
        "type": "o
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "facts": [
   {
    "quote": "Once you meet it, you may pay coinsurance, which is a share of the bill such as 20 percent.",
    "section": "How your plan treats an EKG",
    "source_url": "https://www.healthcare.gov/glossary/co-insurance/"
   }
  ],
  "group": "service",
  "guide": {
   "url": "https://findmydirectdoctor.org/guides/ekg-cost-without-insurance/",
   "slug": "ekg-cost-without-insurance",
   "title": "How much an EKG costs, with or without insurance",
   "last_reviewed": "2026-10-23"
  },
  "query": {
   "topic": "ekg",
   "category": "service",
   "matched_by": "prefix",
   "matched_slug": "ekg-cost-without-insurance"
  },
  "steps": [],
  "credit": "Physician-reviewed, FindMyDirectDoctor Foundation",
  "source": "FindMyDirectDoctor Foundation guides (findmydirectdoctor.org/guides)",
  "related": [
   {
    "url": "https://findmydirectdoctor.org/guides/er-without-insurance/",
    "slug": "er-without-insurance"
   }
  ],
  "sources": [
   {
    "url": "https://pmc.ncbi.nlm.nih.gov/articles/PMC8693213/",
    "publisher": "pmc.ncbi.nlm.nih.gov"
   }
  ],
  "guide_url": "https://findmydirectdoctor.org/guides/ekg-cost-without-insurance/",
  "data_as_of": "2026-10-02",
  "disclaimer": "General information quoted from published guides. Not medical, legal or tax advice. In an emergency call 911.",
  "price_points": [
   {
    "as_of": null,
    "basis": "provider_posted_price",
    "quote": "In 2026, the US middle posted cash price for the hospital's part of an EKG tracing was $185, and the middle half of hospitals posted between $112 and $286.",
    "section": "quick answer",
    "source_url": null,
    "amounts_usd": [
     185,
     112,
     286
    ],
    "basis_label": "price posted by a named provider (confirm before booking)",
    "is_cash_price": true,
    "national_representative": false
   }
  ],
  "price_status": "has_price_points",
  "quick_answer": "In 2026, the US middle posted cash price for the hospital's part of an EKG tracing was $185, and the middle half of hospitals posted between $112 and $286. That price covers the tracing only, so the doctor's reading of it may come as a separate bill. If you have chest pain, call 911 first and deal with the cost later.",
  "last_reviewed": "2026-10-23",
  "price_drivers": [],
  "lower_cost_routes": [],
  "price_status_note": "The guide states price figures. Each keeps its basis label.",
  "how_to_get_a_quote": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-care-cost-lookup-api-c19e2baa/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)
