# FindMyDirectDoctor Guide Index API

> FindMyDirectDoctor Guide Index API is a paid API for AI agents from api.findmydirectdoctor.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Returns a paginated catalog of physician-reviewed guides on paying for health care without insurance, filterable by keyword or category group.

## Facts

- Endpoint: GET https://api.findmydirectdoctor.com/v1/guides/index?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/findmydirectdoctor-guide-index-api-5ebc4724
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nNgd-GmZYMH2OV8yuOmcm

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-guide-index-api-5ebc4724
```

Example prompt: Can you show me all the FindMyDirectDoctor Foundation guides about direct primary care — list their titles, summaries, and whether they include actual price figures?

## When to prefer this

Use this endpoint when you need to discover or browse the full catalog of FindMyDirectDoctor Foundation health-cost guides, filter by category (e.g. dental, dpc, medication, state), or search by keyword before fetching detailed guide content. Prefer this over sibling endpoints when you want metadata about guides (titles, summaries, paid routes) rather than the actual guide content or Q&A answers.

## Known failure modes

- Invalid group value returns empty results or error
- Cursor mismatch (changed query parameters with old cursor) may return unexpected results
- Keyword query with no matches returns empty guides array with total_matches: 0
- Limit exceeding 50 may be clamped or rejected
- Network/payment failure returns HTTP 402 or 5xx

## How this service works

Catalog of the 246 Foundation guides on paying for health care without insurance, with title, one-line summary, group, review date, whether it has price figures and the paid route and topic value that serves it. Browse by group or keyword with paging. Covers cost, medicine, dental, bills, coverage change, direct primary care and all 50 states plus DC.

## Output

A JSON object with total match count, a paginated array of guide records (slug, title, URL, group, summary, last reviewed date, has_price_points flag, paid_routes), a next_cursor for paging, group counts, data_as_of date, source credit, 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": {
      "q": {
       "type": "string",
       "maxLength": 120,
       "description": "Words that must appear in the guide's slug, title, summary or main search phrase."
      },
      "group": {
       "type": "string",
       "maxLength": 40,
       "description": "Only this group: bills, coverage-change, dental, device, dpc, medication, medicare-savings, procedure, program, service, state, vaccine or work-requirement."
      },
      "limit": {
       "type": "integer",
       "default": 25,
       "maximum": 50,
       "minimum": 1,
       "description": "Guides per page (default 25, maximum 50)."
      },
      "cursor": {
       "type": "string",
       "description": "next_cursor of the previous response, with the same other parameters."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "total_matches",
      "guides",
      "credit",
      "data_as_of"
     ],
     "properties": {
      "query": {
       "type": "object",
       "description": "The request as understood."
      },
      "credit": {
       "type": "string",
       "description": "Physician-reviewed, FindMyDirectDoctor Foundation"
      },
      "groups": {
       "type": "object",
       "description": "Number of guides in each group."
      },
      "guides": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "slug",
         "title",
         "url",
         "last_reviewed",
         "paid_routes"
        ],
        "properties": {
         "url": {
          "type": "string"
         },
         "slug": {
          "type": "string"
         },
         "group": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "summary": {
          "type": "string"
         },
         "paid_routes": {
          "type": "array",
   
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "group": "dpc",
   "limit": 2
  },
  "credit": "Physician-reviewed, FindMyDirectDoctor Foundation",
  "groups": {
   "dpc": 9,
   "bills": 14,
   "state": 51,
   "dental": 15,
   "device": 5,
   "program": 20,
   "service": 35,
   "vaccine": 7,
   "procedure": 14,
   "medication": 67,
   "coverage-change": 7,
   "medicare-savings": 1,
   "work-requirement": 1
  },
  "guides": [
   {
    "url": "https://findmydirectdoctor.org/guides/direct-primary-care-cost/",
    "slug": "direct-primary-care-cost",
    "group": "dpc",
    "title": "How much does direct primary care cost?",
    "summary": "Direct primary care usually costs $50 to $200 a month. Here is what changes the price and how to compare.",
    "paid_routes": [
     {
      "route": "/v1/dpc/facts",
      "params": {
       "topic": "direct-primary-care-cost"
      }
     },
     {
      "route": "/v1/answers",
      "params": {
       "q": "how much does direct primary care cost"
      }
     }
    ],
    "price_status": "no_price_stated",
    "last_reviewed": "2026-10-10",
    "has_price_points": false
   },
   {
    "url": "https://findmydirectdoctor.org/guides/direct-primary-care-faq/",
    "slug": "direct-primary-care-faq",
    "group": "dpc",
    "title": "Common questions about direct primary care, answered plainly",
    "summary": "Short, plain answers about cancelling, paying ahead, family plans, same-day visits and more.",
    "paid_routes": [
     {
      "route": "/v1/dpc/facts",
      "params": {
       "topic": "direct-primary-care-faq"
      }
     },
     {
      "route": "/v1/answers",
      "params": {
       "q": "direct primary care frequently asked questions"
      }
     }
    ],
    "price_status": "no_price_stated",
    "last_reviewed": "2026-10-10",
    "has_price_points": false
   }
  ],
  "source": "FindMyDirectDoctor Foundation guides (findmydirectdoctor.org/guides)",
  "returned": 2,
  "data_as_of": "2026-10-02",
  "disclaimer": "General information quoted from published guides. Not medical, legal or tax advice. In an emergency call 911.",
  "next_cursor": "bzoy",
  "last_reviewed": "2026-10-10",
  "total_matches": 9
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-guide-index-api-5ebc4724/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)
