FindMyDirectDoctor Directory API

Endpoints (38 live)

• GET /v1/doctors/telehealth — Telehealth-first and telehealth-included doctors, found near a place or by the state the patient is in (patient_state, matched to licenses on the NPI registry). Separates telehealth included in the membership, telehealth only, and in-person plus telehealth. Each result carries the practice's own wording, source page and grade. Statements are practice-level and do not prove a doctor may treat a patient in another state. (0.02 USDC on Base)
• GET /v1/hospitals/financial-assistance — Finds a hospital's financial assistance (charity care) policy link by CMS certification number (CCN), by hospital name and state with fuzzy matching, or for the nearest hospitals to a location. Returns the hospital's own policy page or an explicit statement that no verified link was found, a state charity-care law note where one is on file, and a plain explanation of the federal rule (section 501(r)) that applies to nonprofit hospitals. (0.02 USDC on Base)
• GET /v1/hospital-prices/stats — Statistics of hospital self-pay (cash) prices for one service in a state or nationwide: number of hospitals, lowest, 25th percentile, median, 75th percentile and highest posted price, plus the national median. The service is a CPT or HCPCS code or plain words such as brain MRI. Built from prices hospitals post under the federal price transparency rule, read in October 2026. Facility portion only. (0.02 USDC on Base)
• GET /v1/costs/care — Cash and self-pay prices for everyday care without insurance, such as a doctor visit, CT scan, colonoscopy, birth control, a surgery, a medical device or a vaccine, from 61 published Foundation guides. Every price figure keeps its quoted sentence, its basis (Medicare payment, posted clinic price, study figure) and its source link, plus price drivers, lower-cost routes and questions for getting a quote. Physician-reviewed, FindMyDirectDoctor Foundation. (0.02 USDC on Base)
• GET /v1/doctors/specialty — Cash-pay and membership specialists near a location: mental health (psychiatrist, psychiatric NP, psychologist, therapist), pediatrics, women's health, dermatology and aesthetics, orthopedics and pain, senior care, integrative, or any directory specialty. Narrows by condition, age group, monthly fee, insurance stance, telehealth and whether new patients are accepted. Specialty is the directory label, not a verified board specialty. (0.02 USDC on Base)
• GET /v1/doctors/treats — 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. (0.03 USDC on Base)
• GET /v1/doctors/home-visits — House-call and home-visit doctors near a ZIP, city or coordinates, as the practice words it: radius, fees, and whether it is for seniors, newborns and postpartum mothers, or members only. Every result links the practice page that says so and shows its source grade. About one listed practice in ten offers home visits, so widen the radius or search by state. (0.02 USDC on Base)
• GET /v1/doctors/background — Credentials search: find doctors by board certification, medical school, residency or fellowship program, hospital affiliation, publications (topic, journal, years), awards, academic title and institution, or years of experience. Results show the matching training, boards and papers with source grades. Only what the practice or the publisher lists, so many doctors list none. Needs a location or state, or an NPI. (0.03 USDC on Base)
• GET /v1/colonoscopy/estimate — Colonoscopy price estimate near a location: posted hospital cash prices for four colonoscopy codes (diagnostic, with biopsy, with polyp removal, screening) with area medians, plus the Medicare 2026 allowed amounts at an ambulatory surgery center (surgery center) versus a hospital outpatient department for that ZIP, split into facility, doctor, anesthesia and lab. Plain explanations included. Reference prices, not quotes. (0.03 USDC on Base)
• GET /v1/coverage/medicaid-check — Screens a household for a likely coverage pathway from state, household size and yearly income: Medicaid may qualify, Marketplace subsidy may qualify, coverage gap, or above the subsidy range. Uses 2026 federal poverty guidelines and KFF-reported state Medicaid limits, reports income as a percent of the poverty line and links the state Medicaid office. Screening estimate only; the state decides. Income is not stored or logged. (0.01 USDC on Base)
• GET /v1/hospital-prices/check — Compares a price quote for a hospital service with hospital cash prices posted within 50 miles of a ZIP code, falling back to the state. Returns the percentile of the quote, the local median and range, a neutral label (below typical, typical, above typical, far above typical) and plain next steps such as asking for an itemized bill, asking about a self-pay discount and financial assistance (charity care) links. Not legal or medical advice. (0.05 USDC on Base)
• GET /v1/doctors/by-language — Doctors who speak a language such as Spanish, Mandarin, Hindi, Arabic or Vietnamese, near a ZIP, city or coordinates. Each result says whether the clinician or only the practice staff is stated to speak it, with the source grade and page. Filters by specialty, credential, practice model and insurance stance. Languages come only from the practice's own site, so a rare language may return no match. (0.02 USDC on Base)
• GET /v1/conditions/resolve — 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. (0.01 USDC on Base)
• GET /v1/states/care-without-insurance — State-by-state options for getting care without insurance: the state's Medicaid program name, whether it expanded Medicaid and whether adults fall in the coverage gap, the Medicaid work-rule start date its guide gives, the state license lookup page for checking a doctor, the DPC law where a guide states one, and the count of HRSA health center sites. One state per request. (0.03 USDC on Base)
• GET /v1/health-centers — HRSA-funded community health centers (sliding fee clinics that charge by income) near a ZIP code, city and state, or latitude/longitude, with address, phone and website. Source: HRSA Health Center Program, ODbL 1.0. (0.01 USDC on Base)
• GET /v1/clinics/included — Doctor's offices near a place whose membership plans state a given item, such as labs, generic medications, telehealth, house calls, same-day visits or 24/7 phone access, with the plan, its price and the practice's own wording. One result per practice. A practice not shown did not state the item in the pages read, which does not mean it is excluded. Published by the practice; confirm before booking. (0.02 USDC on Base)
• GET /v1/clinics/membership-prices — Membership price sheet of one US doctor's office, read from its own website: every plan with its monthly, yearly or one-time price, who it covers (adult, child, family, couple, senior, employer), what it lists as included, the enrollment fee and the extra costs. Also finds enrollment fees or extra charges near a place. Covers direct primary care (DPC) and concierge practices. Published by the practice; confirm before booking. (0.02 USDC on Base)
• GET /v1/specialties/list — 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. (0.01 USDC on Base)
• GET /v1/answers — Short answers to common money questions about health care without insurance, found by keyword search over 1,525 question-and-answer pairs from 246 Foundation guides on cash prices, medical bills, Medicaid, direct primary care, medicines and dental care. Each answer comes with its guide link, review date and the physician-review credit. (0.01 USDC on Base)
• GET /v1/care-options — One-call overview of lower-cost care options near a location: the 3 lowest-priced direct primary care (DPC) and cash-pay doctors, the 3 nearest HRSA health centers (sliding fee clinics), and, when a service is named, the 3 lowest posted hospital cash prices with the area median and financial assistance links. Includes a short plain options overview. (0.05 USDC on Base)

+18 more endpoints.