{"uid":"cap_EkUkLJorXi4pKT2G5VKVL","slug":"findmydirectdoctor-specialties-list-api-84544376","name":"FindMyDirectDoctor Specialties List API","description":"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.","url":"https://api.findmydirectdoctor.com/v1/specialties/list?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":[],"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"}}}}}}}}}},"responseSchema":{"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}]}},"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_Kwo4A0UkAZPJYDD85Ffgd","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":"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.","exampleAgentPrompt":"What specialties are available for concierge medicine on FindMyDirectDoctor? Show me just the non-generalist ones, and filter for anything related to 'heart'.","exampleUseCases":[{"title":"Exploring DPC specialty coverage","prompt":"Can you list all the medical specialties that have DPC doctors on FindMyDirectDoctor, excluding family medicine and internal medicine?"},{"title":"Finding a cardiology-related specialty","prompt":"Search the FindMyDirectDoctor specialty list for anything related to 'heart' and tell me the plain-language name and how many conditions are mapped to it."},{"title":"Comparing concierge medicine specialties","prompt":"Show me all the specialties available under the concierge practice model on FindMyDirectDoctor, including how many conditions each one covers."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:47.111Z","isFirstParty":false,"canonicalSlug":"findmydirectdoctor-specialties-list-api-84544376"}