# FindMyDirectDoctor Directory API – Doctors by Language > FindMyDirectDoctor Directory API – Doctors by Language is a paid API for AI agents from api.findmydirectdoctor.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-31). Finds cash-pay, DPC, and concierge doctors near a location who speak a specified language, with per-result notes on whether the clinician or only staff speaks it. ## Facts - Endpoint: GET https://api.findmydirectdoctor.com/v1/doctors/by-language?utm_source=zero.xyz - Price: $0.02/call - Payment: x402 - Status: unknown - Last checked: 2026-10-31 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/findmydirectdoctor-directory-api-doctors-by-language-950db1d2 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_akUm69ZPCjmnI_Qbz9xyW 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-directory-api-doctors-by-language-950db1d2 ``` Example prompt: Find me Spanish-speaking doctors near ZIP 33133 in the FindMyDirectDoctor directory — show up to 10 results, and make sure you flag whether it's the actual doctor or just the practice staff who speaks Spanish, using the 'any' scope. ## When to prefer this Use this endpoint when the user's primary filter is a spoken language and they need cash-pay, DPC, or concierge doctors (not insurance-billed practices). It is uniquely suited for finding multilingual clinicians in non-traditional practice models with evidence grading on whether the doctor personally speaks the language. Prefer it over generic physician directory APIs when language access and practice model (DPC, concierge, cash) are central requirements. ## Known failure modes - Rare language returns zero results — the directory only reflects what practices publish on their own sites - Invalid or unsupported language string returns empty results or an error - ZIP code not recognized returns no results - City+state combination that has no listed doctors returns empty list - Cursor value from a different query set causes a pagination mismatch or error - Exceeding the limit of 25 per page returns a validation error ## How this service works Spanish-speaking cash-pay doctor nearby. Doctors in a cash-pay and membership directory 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 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. ## Output A paginated JSON list of matching clinicians with their name, practice name, distance in miles, specialty, credentials, practice model, phone, website, and a matched_language object showing which language matched, whether the clinician or practice/staff speaks it, and an evidence grade. Also includes a next_cursor for pagination, data freshness date, and a coverage disclaimer. ## 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", "required": [ "language" ], "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." }, "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." }, "scope": { "enum": [ "doctor", "practice", "any" ], "type": "string", "default": "any", "description": "doctor = the clinician is stated to speak it. practice = only the practice or staff. any (default) = either, labelled in the result." }, "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": [ … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "count": 10, "query": { "limit": 10, "format": "concise", "language": "Spanish", "location": "ZIP 33133", "radius_miles": 15 }, "source": "FindMyDirectDoctor directory", "results": [ { "city": "Miami", "name": "Camilo Andres Murillo", "state": "FL", "website": "https://www.directprimarycareofcoconutgrove.com/", "evidence": { "as_of": "2026-10-27", "basis": [ "own_site" ], "grade_min": "C" }, "doctor_id": "fd_s2fxt2aenp", "language_note": "Languages are what the practice site states. 'practice' means the clinic or staff, not necessaril...", "practice_name": "Direct Primary Care of Coconut Grove", "distance_miles": 2.3, "practice_model": "concierge", "practice_phone": "305-812-2208", "specialty_label": "Family Medicine", "credential_class": "NP", "credentials_text": "APRN", "languages_listed": [ { "grade": "C", "language": "French", "stated_for": "practice" }, { "grade": "C", "language": "Portuguese", "stated_for": "practice" } ], "matched_language": { "grade": "C", "language": "Spanish", "stated_for": "the practice only" }, "location_precision": "city" }, { "city": "Miami", "name": "Paola Garcia-Herreros", "state": "FL", "website": "https://www.theconciergepediatrics.com/", "evidence": { "as_of": "2026-10-27", "basis": [ "npi_registry", "own_site" ], "grade_min": "C" }, "doctor_id": "fd_ozywjib24u", "language_note": "Languages are what the practice site states. 'practice' means the clinic or staff, not necessaril...", "practice_name": "The Concierge Pediatrics", "distance_miles": 2.3, "practice_model": "concierge", "specialty_label": "Pediatrics", "credential_class": "NP", "credentials_text": "APRN", "languages_listed": [ { "grade": "C", "language": "Spanish", "stated_for": "clinician" } ], "matched_language": { "grade": "C", "language": "Spanish", "stated_for": "the clinician" }, "location_precision": "city" } ], "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 … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-directory-api-doctors-by-language-950db1d2/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)