# FindMyDirectDoctor Background Credentials Search API > FindMyDirectDoctor Background Credentials Search API is a paid API for AI agents from api.findmydirectdoctor.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-31). 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. ## Facts - Endpoint: GET https://api.findmydirectdoctor.com/v1/doctors/background?utm_source=zero.xyz - Price: $0.03/call - Payment: x402 - Status: unknown - Last checked: 2026-10-31 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/findmydirectdoctor-background-credentials-search-api-af45945a - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AYa5erGey8WTtTgsZXMwc Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability findmydirectdoctor-background-credentials-search-api-af45945a ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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. ## Output 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. ## Request schema (JSON Schema) ```json { "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": { … (truncated) ``` ## Response schema (JSON Schema) ```json { "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 }, … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-background-credentials-search-api-af45945a/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.findmydirectdoctor.com](https://www.zero.xyz/host/api.findmydirectdoctor.com/llms.txt)