# FindMyDirectDoctor Condition Resolver API > FindMyDirectDoctor Condition Resolver 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). Matches everyday health words or lay terms to canonical condition names, relevant specialist types, and proposed billing codes for price lookups ## Facts - Endpoint: GET https://api.findmydirectdoctor.com/v1/conditions/resolve?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-condition-resolver-api-4c572b7d - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O6C_oSbvfJQQ56CgXDna6 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-condition-resolver-api-4c572b7d ``` Example prompt: What's the canonical medical name for 'bad back', which specialists treat it, and what billing codes should I look up for price comparison — give me the top 3 matches from the FindMyDirectDoctor condition table? ## When to prefer this Choose this endpoint when you need to bridge plain-language patient terminology to structured medical condition names and billing codes, particularly for price-transparency lookups or specialist navigation. It covers 3,577 conditions and 319 lay terms with physician-reviewed data. Prefer it over general medical NLP APIs when you specifically need specialty routing and billing code suggestions in a single call, and when a $0.01-per-call micropayment model is acceptable. Avoid it for actual diagnostic purposes — it is name-matching only, not a clinical decision support tool. ## Known failure modes - Query string too short or empty — validation error returned - No matching condition found for highly unusual or misspelled terms — empty matches array - Emergency condition detected — specialties and codes omitted, call-911 notice returned instead - Query exceeds 120-character limit — rejected with input validation error - Limit parameter outside 1-10 range — clamped or rejected - Payment failure for x402 micropayment — request blocked before processing ## How this service works Everyday health words such as sugar, bad back or high bp matched to a canonical condition name, the kinds of specialists the Foundation condition table lists for it, and proposed related billing codes for price lookups. Emergency conditions return a call-911 notice and no codes. Name matching over 3,577 conditions and 319 lay terms; not a diagnosis. ## Output Returns a JSON object with the interpreted query, one or more matched canonical condition names (up to the requested limit), an emergency boolean flag per match (with a call-911 notice and no codes if true), a list of specialist types (with plain-language labels) from the Foundation table, proposed related CPT/HCPCS billing codes with plain names and categories, a confidence indicator (e.g. lay_term vs exact match), the data-as-of date, a disclaimer, and attribution credit to the FindMyDirectDoctor Foundation. ## 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": [ "q" ], "properties": { "q": { "type": "string", "maxLength": 120, "minLength": 1, "description": "Everyday words or a condition name, for example sugar, bad back, high bp or hypertension." }, "limit": { "type": "integer", "default": 5, "maximum": 10, "minimum": 1, "description": "Conditions to return (default 5, maximum 10)." } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "required": [ "query", "credit", "data_as_of" ], "properties": { "note": { "type": "string" }, "match": { "type": "string", "description": "symptom_not_diagnosis when the words are a symptom." }, "notes": { "type": "array", "items": { "type": "string" } }, "query": { "type": "object", "description": "The request as understood." }, "credit": { "type": "string", "description": "Physician-reviewed, FindMyDirectDoctor Foundation" }, "source": { "type": "string" }, "matches": { "type": "array", "items": { "type": "object", "required": [ "condition", "emergency", "specialties", "related_codes" ], "properties": { "kind": { "type": "string" }, "notice": { "type": "string" }, "condition": { "type": "string" }, "emergency": { "type": "boolean", "description": "true for emergency conditions: a call-911 notice is shown and no codes." }, "also_called": { "type": "array", "items": { "type": "string" } }, "specialties": { "typ … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "notes": [ "Name matching only. The words are matched to condition names in a table. This does not say what anyone has.", "Specialties are the kinds of clinician the Foundation table lists for the condition. A family doctor or internist may also see it.", "Proposed, pending physician review: billing codes often ordered with this condition, listed only so a price lookup can start. They are not advice about what a person needs." ], "query": { "q": "sugar", "limit": 1 }, "credit": "Physician-reviewed, FindMyDirectDoctor Foundation", "source": "FindMyDirectDoctor Foundation condition table (3,577 conditions), lay terms and code pairs proposed and pending physician review", "matches": [ { "condition": "diabetes", "emergency": false, "specialties": [ { "id": "s_endocrinology", "label": "Endocrinology", "plain_name": "hormone and diabetes doctor (endocrinologist)" }, { "id": "s_pediatrics", "label": "Pediatrics", "plain_name": "children's doctor (pediatrician)" } ], "related_codes": [ { "code": "83036", "category": "lab", "plain_name": "A1C blood sugar test" }, { "code": "80048", "category": "lab", "plain_name": "Basic metabolic panel (BMP)" }, { "code": "80053", "category": "lab", "plain_name": "Comprehensive metabolic panel (CMP)" } ], "related_codes_status": "proposed, pending physician review", "primary_care_also_listed": true } ], "returned": 1, "confidence": "lay_term", "data_as_of": "2026-10-02", "disclaimer": "General information quoted from published guides. Not medical, legal or tax advice. In an emergency call 911.", "matched_via": "lay_term", "total_matches": 1 } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-condition-resolver-api-4c572b7d/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)