{"uid":"cap_O6C_oSbvfJQQ56CgXDna6","slug":"findmydirectdoctor-condition-resolver-api-4c572b7d","name":"FindMyDirectDoctor Condition Resolver API","description":"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.","url":"https://api.findmydirectdoctor.com/v1/conditions/resolve?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"plain_name":{"type":"string"}}}},"related_codes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"category":{"type":"string"},"plain_name":{"type":"string"}}}},"related_codes_status":{"type":"string","description":"Proposed, pending physician review."},"primary_care_also_listed":{"type":"boolean"}}}},"returned":{"type":"integer"},"candidates":{"type":"array","items":{"type":"string"}},"confidence":{"type":"string"},"data_as_of":{"type":"string"},"disclaimer":{"type":"string"},"matched_via":{"type":"string","description":"condition_name, lay_term, lay_term_in_phrase, all_words or some_words."},"total_matches":{"type":"integer"},"emergency_notice":{"type":"string","description":"Shown first whenever a match is an emergency condition."}}}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xP3zaYc5k1nw7GIj8jXSB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Matches everyday health words or lay terms to canonical condition names, relevant specialist types, and proposed billing codes for price lookups","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Translate lay symptom to billing codes","prompt":"I keep hearing people say 'high bp' — what does that map to medically, what kind of doctor handles it, and what CPT codes would I need to look up hospital prices for it?"},{"title":"Check if condition is an emergency","prompt":"My patient navigator app received the query 'chest tightness' — can you check if this maps to an emergency condition in the FindMyDirectDoctor table, and if not, what specialists and billing codes come up?"},{"title":"Build specialist referral suggestion","prompt":"A user typed 'sugar problems' into my health app — look that up in the condition resolver and return up to 5 matching conditions with their specialist types so I can suggest the right kind of doctor."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:34:20.773Z","isFirstParty":false,"canonicalSlug":"findmydirectdoctor-condition-resolver-api-4c572b7d"}