{"uid":"cap_G8-HsQHxc5urpyfwfgnsU","slug":"findmydirectdoctor-directory-api-doctors-by-condition-or-service-48073d56","name":"FindMyDirectDoctor Directory API – Doctors by Condition or Service","description":"Which doctors treat a condition or offer a service, such as anxiety, diabetes, acne, Botox or knee pain, near a location. Every match is labelled stated (the practice lists it, with the page) or specialty-inferred (the specialty usually treats it, the practice did not say so). Stated matches come first. Generalist labels are never used to infer. Not a referral or a recommendation.","url":"https://api.findmydirectdoctor.com/v1/doctors/treats?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":["topic"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude in decimal degrees. Used together with lng."},"lng":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude in decimal degrees. Used together with lat."},"zip":{"type":"string","pattern":"^\\d{5}$","maxLength":5,"description":"5-digit US ZIP code. A location is zip, or lat with lng, or city with state."},"city":{"type":"string","maxLength":80,"description":"City name. Used together with state; resolves only for cities that have listed doctors."},"basis":{"enum":["stated","specialty-inferred","any"],"type":"string","default":"any","description":"stated = the practice lists it. specialty-inferred = the specialty usually treats it but the practice did not say so. any (default) = both, stated first."},"limit":{"type":"integer","default":10,"maximum":25,"minimum":1,"description":"Results per page (maximum 25)."},"model":{"enum":["dpc","concierge","cash_specialist","any"],"type":"string","default":"any","description":"Practice model: dpc, concierge, cash_specialist or any."},"state":{"type":"string","pattern":"^[A-Za-z]{2}(,[A-Za-z]{2}){0,4}$","maxLength":14,"description":"2-letter US state code. With city it names the city's state. On its own it limits results to that state (up to 5 codes separated by commas)."},"topic":{"type":"string","maxLength":80,"description":"Required. Condition or service in plain words, for example anxiety, diabetes, acne, Botox, knee pain, ADHD."},"cursor":{"type":"string","maxLength":40,"description":"Opaque next_cursor value from the previous response, to fetch the next page with the same other parameters."},"format":{"enum":["concise","detailed"],"type":"string","default":"concise","description":"concise = key fields. detailed = every field we hold."},"insurance":{"enum":["does_not_bill","bills_some_services","accepts_hsa_fsa","keep_insurance_for_emergencies","bills_insurance","any"],"type":"string","description":"What the practice states about insurance: does_not_bill, bills_some_services, accepts_hsa_fsa, keep_insurance_for_emergencies, bills_insurance or any."},"specialty":{"type":"string","maxLength":80,"description":"Specialty label or group, for example family-medicine, psychiatry, dermatology, mental-health, womens-health. Matched against the FindMyDirectDoctor directory label."},"credential":{"enum":["MD","DO","NP","PA","other","physician"],"type":"string","description":"Clinician type: MD, DO, NP (nurse practitioner), PA (physician assistant), other (for example naturopathic or counselor) or physician (MD or DO)."},"radius_miles":{"type":"number","default":25,"maximum":100,"minimum":0,"description":"Search radius in miles (maximum 100). Used with a location."},"verified_only":{"enum":["true","false"],"type":"string","description":"true keeps only matches whose supporting fact is graded A or B (registry, board, hospital bio, or a second source). Default false."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["total_matches","results","data_as_of"],"properties":{"count":{"type":"integer"},"query":{"type":"object","description":"The filters as understood, with any notes."},"source":{"type":"string"},"results":{"type":"array","items":{"type":"object","description":"One clinician. Fields not stated by the practice are null or absent."}},"returned":{"type":"integer"},"data_as_of":{"type":"string"},"disclaimer":{"type":"string"},"next_cursor":{"type":["string","null"]},"coverage_note":{"type":"string"},"total_matches":{"type":"integer"},"statement_basis":{"type":"string","description":"Facts are what the practice states on its own site, with a source grade."}}}}}}},"responseSchema":{"type":"json","example":{"count":10,"query":{"basis":"any","limit":10,"topic":"anxiety","format":"concise","location":"ZIP 80202","radius_miles":25},"source":"FindMyDirectDoctor directory","results":[{"zip":"80218","city":"Denver","name":"Kendall Stone","match":{"note":"The practice lists this on its own site. Listed does not mean outcome or recommendation.","basis":"stated","scope":"practice listing","matched_services":[{"grade":"C","label":"Mental Health: Depression and Anxiety","listed_by":"practice page","source_url":"https://www.stonemedicaldpc.com/"}]},"state":"CO","website":"https://www.stonemedicaldpc.com/","evidence":{"as_of":"2026-10-02","basis":["own_site"],"grade_min":"C"},"doctor_id":"fdd-N01639","practice_name":"Stone Medical","distance_miles":1.3,"practice_model":"dpc","practice_phone":"(720) 819-6181","specialty_label":"Internal Medicine","credential_class":"MD","credentials_text":"MD","location_precision":"street"},{"zip":"80205","city":"Denver","name":"Charlisa Davenport","match":{"note":"The practice lists this on its own site. Listed does not mean outcome or recommendation.","basis":"stated","scope":"practice listing","matched_services":[{"grade":"C","label":"Anxiety","listed_by":"practice page","source_url":"https://www.reiffmentalhealth.com/treatment-options"}]},"state":"CO","website":"https://www.reiffmentalhealth.com","evidence":{"as_of":"2026-10-02","basis":["own_site"],"grade_min":"C"},"doctor_id":"fdd-N01633","practice_name":"Reiff Mental Health","distance_miles":2.8,"practice_model":"concierge","practice_phone":"(303) 803-5726","specialty_label":"Psychiatry","credential_class":"NP","credentials_text":"MSN, PMHNP-BC","location_precision":"street"}],"returned":10,"data_as_of":"2026-10-02","disclaimer":"Prices and availability change. Confirm directly with the practice before making care decisions.","next_cursor":"bzoxMA==","coverage_note":"Directory of cash-pay, direct primary care (DPC) and concierge practices, not every doctor.","total_matches":26,"statement_basis":"Facts are shown as the practice or publisher states them. Grade A = federal registry, board or ho..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iCR-cqO_TNxwzd9aez6QJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked list of nearby cash-pay, DPC, and concierge doctors who treat a given condition or offer a service, with each match labeled as stated (practice lists it) or specialty-inferred.","exampleAgentPrompt":"Find me doctors near ZIP 80202 who treat anxiety — show up to 10 results, prefer ones where the practice explicitly lists it (stated matches), and only show DPC or concierge practices.","exampleUseCases":[{"title":"Uninsured patient finding anxiety care","prompt":"I don't have insurance and I'm looking for a doctor near Denver who treats anxiety — can you find me up to 10 practices in the 80202 area, prioritizing ones that actually list mental health services on their website?"},{"title":"Locating cash-pay Botox provider","prompt":"Can you find cash-pay or concierge doctors near ZIP 90210 who offer Botox, and tell me which ones explicitly list it as a service versus just being inferred from their specialty?"},{"title":"Parent seeking ADHD treatment for child","prompt":"I need to find a direct primary care or concierge doctor near Austin, TX who treats ADHD — show me practices that state they offer this service, up to 15 results."}],"resultDescription":"A JSON object containing a list of up to 25 matched doctors sorted by stated vs. specialty-inferred basis then by distance, each with doctor name, practice name, distance in miles, practice model, specialty, credentials, phone, website, match basis, matched service labels with evidence grades and source URLs, and a next_cursor for pagination. Also includes query echo, coverage note, data freshness date, and disclaimer.","failureModes":["Missing required 'topic' parameter returns a 400 error","Invalid or unresolvable location (unknown city/state combo) returns empty results or a location error","topic is too vague or non-medical and returns zero matches","ZIP code not in directory coverage area returns empty results","Exceeding limit of 25 returns a validation error","Expired or invalid cursor returns a pagination error","Rate limit or payment failure (x402) returns a 402 response"],"whenToPreferThis":"Use this endpoint when an agent needs to find specific doctors or practices that treat a named condition or offer a named service within a geographic area, particularly in the cash-pay, DPC, or concierge space. It is superior to general provider directories because it distinguishes between practices that explicitly list a service versus those inferred by specialty, and it is scoped to direct-pay practices rather than insurance networks. Choose this over the language or new-patient endpoints when the primary filter is condition or service type.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:03.667Z","isFirstParty":false,"canonicalSlug":"findmydirectdoctor-directory-api-doctors-by-condition-or-service-48073d56"}