{"uid":"cap_AYa5erGey8WTtTgsZXMwc","slug":"findmydirectdoctor-background-credentials-search-api-af45945a","name":"FindMyDirectDoctor Background Credentials Search API","description":"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.","url":"https://api.findmydirectdoctor.com/v1/doctors/background?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","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."},"npi":{"type":"string","pattern":"^\\d{10}$","maxLength":10,"description":"10-digit National Provider Identifier (checked with the Luhn formula)."},"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."},"board":{"type":"string","maxLength":60,"description":"Board certification the practice states, as a slug or words, for example family-medicine, dermatology, ABIM."},"limit":{"type":"integer","default":10,"maximum":25,"minimum":1,"description":"Results per page (maximum 25)."},"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)."},"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."},"school":{"type":"string","maxLength":80,"description":"Medical, nursing or PA school, for example Johns Hopkins, Ross University, PCOM, Mayo."},"journal":{"type":"string","maxLength":80,"description":"Journal name or part of it."},"program":{"type":"string","maxLength":80,"description":"Residency, fellowship or internship program or institution, for example Mayo Clinic, Cedars-Sinai."},"year_to":{"type":"integer","maximum":2100,"minimum":1950,"description":"Latest publication year."},"academic":{"enum":["true","false"],"type":"string","description":"true keeps clinicians who list a teaching, faculty or research role."},"hospital":{"type":"string","maxLength":80,"description":"Hospital or health system named in the practice's biography, for example Mayo Clinic, Scripps."},"max_years":{"type":"integer","maximum":80,"minimum":0,"description":"Maximum years of experience the practice states."},"min_years":{"type":"integer","maximum":80,"minimum":0,"description":"Minimum years of experience the practice states."},"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."},"year_from":{"type":"integer","maximum":2100,"minimum":1950,"description":"Earliest publication year."},"award_type":{"enum":["any","top-doctor-list","castle-connolly","alpha-omega-alpha","rising-star","teaching","fellowship"],"type":"string","description":"any, top-doctor-list, castle-connolly, alpha-omega-alpha, rising-star, teaching, fellowship."},"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)."},"min_papers":{"type":"integer","maximum":500,"minimum":1,"description":"Minimum number of listed papers."},"institution":{"type":"string","maxLength":80,"description":"Institution named in an academic role, for example Stanford."},"school_type":{"enum":["medical","osteopathic","nursing","pa_program","any"],"type":"string","default":"any","description":"medical, osteopathic, nursing, pa_program or any (default)."},"include_weak":{"enum":["true","false"],"type":"string","description":"true also counts papers matched only by place or without an affiliation, flagged as weak."},"radius_miles":{"type":"number","default":25,"maximum":100,"minimum":0,"description":"Search radius in miles (maximum 100). Used with a location."},"relationship":{"enum":["any","privileges_or_staff","trained_at","employed_past"],"type":"string","default":"any","description":"any (default), privileges_or_staff, trained_at or employed_past."},"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."},"academic_title":{"enum":["professor","associate-professor","assistant-professor","clinical-instructor"],"type":"string","description":"professor, associate-professor, assistant-professor or clinical-instructor."},"training_stage":{"enum":["residency","fellowship","internship","any"],"type":"string","default":"any","description":"residency, fellowship, internship or any (default); limits where program is looked for."},"fellowship_field":{"type":"string","maxLength":80,"description":"Fellowship field, for example Mohs surgery, reproductive endocrinology."},"named_board_only":{"enum":["true","false"],"type":"string","description":"true keeps only certifications that name a board, such as the American Board of Internal Medicine."},"publication_topic":{"type":"string","maxLength":80,"description":"Words from a paper title, for example hypertension, melanoma, sleep."}}}},"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"},"matches":{"type":"array"},"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":{"limit":10,"format":"concise","school":"Baylor","location":"TX"},"source":"FindMyDirectDoctor directory","results":[{"zip":"75246","city":"Dallas","name":"Cassue Braun","state":"TX","matched":{"school":["Baylor University Medical Center, Houston"]},"website":"https://www.dallashealthpartners.com","evidence":{"as_of":"2026-10-27","basis":["own_site"],"grade_min":"C"},"doctor_id":"fd_yizeaglh6m","background":{"training":{"schools":[{"text":"Baylor University Medical Center, Houston","type":"pa_program","grade":"C","source_url":"https://www.dallashealthpartners.com/our-team"}],"residency":[],"fellowship":[],"internship":[]},"doctor_id":"fd_yizeaglh6m","recognition":[],"publications":{"count":0,"papers":[],"weak_matches":0},"academic_roles":[],"board_certifications":[],"hospital_affiliations":[]},"practice_name":"Dallas Health Partners","practice_model":"concierge","specialty_label":"Integrative Medicine","credential_class":"PA","credentials_text":"PA-C","location_precision":"zip"},{"zip":"75225","city":"Dallas","name":"Reuben Elovitz","state":"TX","matched":{"school":["Baylor College of Medicine to"]},"website":"https://www.privatehealthdallas.com","evidence":{"as_of":"2026-10-27","basis":["own_site"],"grade_min":"C"},"doctor_id":"fd_ct63v2fwt2","background":{"training":{"schools":[{"text":"Baylor College of Medicine to","type":"medical","grade":"C","source_url":"https://privatehealthdallas.com/team/"}],"residency":[{"text":"Internal medicine, Washington University School of Medicine, 1998 to 2001","grade":"B","source_url":"https://privatehealthdallas.com/team/"}],"fellowship":[],"internship":[]},"doctor_id":"fd_ct63v2fwt2","recognition":[],"publications":{"count":0,"papers":[],"weak_matches":0},"academic_roles":[],"board_certifications":[],"hospital_affiliations":[]},"practice_name":"Private Health Dallas","practice_model":"concierge","specialty_label":"Internal Medicine","credential_class":"MD","credentials_text":"MD","location_precision":"zip"}],"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":12,"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_iaMJvXExKrvWhRX3duacM","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":"Search US doctors by board certification, medical school, residency/fellowship, hospital affiliation, publications, awards, or academic title, filtered by location or NPI, returning verified credential evidence with source grades.","exampleAgentPrompt":"Find me doctors in Dallas, TX who went to Baylor for medical school and are board certified in internal medicine — show me the detailed credential view with their training sources and evidence grades.","exampleUseCases":[{"title":"Verify physician board certification before appointment","prompt":"I'm considering a new cardiologist in Chicago, IL — can you look up doctors board certified in cardiology there and show me their certifications and which boards they hold, with the source evidence grades?"},{"title":"Find fellowship-trained specialist by NPI","prompt":"Can you pull the full background on NPI 1234567893 — I want to see their fellowship training, any publications, and hospital affiliations with the detailed format?"},{"title":"Research academic physicians with publications","prompt":"Find me internists near ZIP 10021 in New York who have published in peer-reviewed journals, and show me which papers they list and what journals they appeared in."}],"resultDescription":"A paginated JSON list of matching doctors, each with name, location, specialty, credential class, and a background object containing training (medical school, residency, fellowship, internship), board certifications, hospital affiliations, publications (with paper count and weak matches), academic roles, and recognition/awards. Each credential item includes source URL, evidence grade (A–C), and as-of date. Also returns a query echo and total count.","failureModes":["Missing location parameter and no NPI provided — API requires at least one of: zip, lat+lng, city+state, state, or NPI","Invalid NPI format (not exactly 10 digits or fails Luhn check) — rejected with validation error","No matching doctors found for the given credential filter and location — empty results array","Highly filtered queries (rare board + rare school + narrow geography) may return zero results even if doctors exist but haven't listed credentials","Cursor mismatch or expired cursor returns error or unexpected page","State code not recognized — must be valid 2-letter US state abbreviation"],"whenToPreferThis":"Use this endpoint when you need to search or verify a physician's educational background, board certifications, residency/fellowship training, hospital affiliations, or publication history — especially when filtering by location or NPI. Prefer this over a general doctor-search endpoint when the credential filter (school, board, journal, award, academic title) is the primary search criterion. Best for due-diligence scenarios, credential verification, or finding specialists with specific training pedigrees. Not suitable if you only need pricing, insurance status, or language preferences — sibling endpoints handle those.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:16.382Z","isFirstParty":false,"canonicalSlug":"findmydirectdoctor-background-credentials-search-api-af45945a"}