# FindMyDirectDoctor Specialties List API

> FindMyDirectDoctor Specialties List 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 filterable list of the 53 medical specialties in the FindMyDirectDoctor Foundation condition table, with plain-language names, practice model support (DPC/concierge), and condition counts.

## Facts

- Endpoint: GET https://api.findmydirectdoctor.com/v1/specialties/list?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-specialties-list-api-84544376
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EkUkLJorXi4pKT2G5VKVL

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-specialties-list-api-84544376
```

Example prompt: What specialties are available for concierge medicine on FindMyDirectDoctor? Show me just the non-generalist ones, and filter for anything related to 'heart'.

## When to prefer this

Use this endpoint when you need to discover or enumerate medical specialties available in the FindMyDirectDoctor directory, especially to understand which specialties support DPC or concierge practice models, or to find plain-language specialty names and their associated condition counts. Prefer this over doctor-search endpoints when the goal is taxonomy exploration or filtering by practice model rather than finding specific physicians.

## Known failure modes

- Invalid practice_model enum value returns an error
- Keyword query with no matches returns total:0 and empty specialties array
- Malformed query parameters may return a 400 error
- Data may be stale if the Foundation condition table has been updated since data_as_of date

## How this service works

List of the 53 specialties in the Foundation condition table with plain-language names, whether each is a generalist (family or internal medicine), the practice models (DPC, concierge) listed for it and how many conditions map to it. Filterable by word or practice model. Names and counts only, no doctors.

## Output

Returns a JSON object with the total count of matching specialties and an array of specialty objects, each containing an ID, formal label, plain-language name, whether it is a generalist specialty, which practice models (DPC and/or concierge) it appears under, and the number of Foundation conditions mapped to it. Also includes metadata: data date, credit attribution, 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 specialty name or plain name, for example heart."
      },
      "practice_model": {
       "enum": [
        "dpc",
        "concierge"
       ],
       "type": "string",
       "description": "Only specialties listed for this practice model."
      },
      "include_generalist": {
       "type": "boolean",
       "default": true,
       "description": "false leaves out Family Medicine and Internal Medicine."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "total",
      "specialties",
      "credit",
      "data_as_of"
     ],
     "properties": {
      "note": {
       "type": "string"
      },
      "query": {
       "type": "object",
       "description": "The request as understood."
      },
      "total": {
       "type": "integer"
      },
      "credit": {
       "type": "string",
       "description": "Physician-reviewed, FindMyDirectDoctor Foundation"
      },
      "source": {
       "type": "string"
      },
      "data_as_of": {
       "type": "string"
      },
      "disclaimer": {
       "type": "string"
      },
      "specialties": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": "string"
         },
         "label": {
          "type": "string"
         },
         "generalist": {
          "type": "boolean"
         },
         "plain_name": {
          "type": "string"
         },
         "practice_models": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "conditions_mapped": {
          "type": "integer"
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Family Medicine and Internal Medicine are generalist labels and are not counted as specialty matches. Counts are conditions in the Foundation table, not doctors.",
  "query": {
   "q": "heart",
   "include_generalist": true
  },
  "total": 1,
  "credit": "Physician-reviewed, FindMyDirectDoctor Foundation",
  "source": "FindMyDirectDoctor Foundation condition table (3,577 conditions), lay terms and code pairs proposed and pending physician review",
  "data_as_of": "2026-10-02",
  "disclaimer": "General information quoted from published guides. Not medical, legal or tax advice. In an emergency call 911.",
  "specialties": [
   {
    "id": "s_cardiology",
    "label": "Cardiology",
    "generalist": false,
    "plain_name": "heart doctor (cardiologist)",
    "practice_models": [
     "concierge"
    ],
    "conditions_mapped": 244
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-specialties-list-api-84544376/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)