# FindMyDirectDoctor Specialty Directory Search > FindMyDirectDoctor Specialty Directory Search 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). Returns a paginated list of cash-pay and membership doctors near a location, filtered by specialty (mental health, pediatrics, dermatology, orthopedics, etc.) and optional criteria like condition, age group, telehealth, and monthly fee. ## Facts - Endpoint: GET https://api.findmydirectdoctor.com/v1/doctors/specialty?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-specialty-directory-search-1f348bca - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wW7QnQERge6zFRv_hdCyb 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-specialty-directory-search-1f348bca ``` Example prompt: Can you find me cash-pay or membership psychiatrists near ZIP 10001 in New York who are accepting new patients and offer telehealth, using the FindMyDirectDoctor directory? ## When to prefer this Use this endpoint when you need to find cash-pay, DPC, or concierge doctors of a specific specialty near a location, especially when the user is uninsured or seeking non-insurance-based care. Prefer this over generic provider directories when filtering by practice model, monthly fee, telehealth availability, or new-patient acceptance is important. Not suitable for finding in-network insurance providers or verifying board certifications. ## Known failure modes - Missing required 'specialty' parameter returns a validation error - No location provided (zip, lat/lng, or city+state) may return results without geographic ranking or an error - Invalid ZIP code format (not 5 digits) fails schema validation - Cursor from a different query set causes unexpected results or an error - Specialty label not in directory returns zero results - Rate limiting or payment failure at $0.02 USDC per call if x402 payment is not properly handled ## How this service works 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. ## Output A paginated JSON list of up to 25 matching doctors per page, each including name, practice name, specialty label, credential class, practice model (DPC, concierge, cash_specialist), city, state, ZIP, distance in miles, website URL, evidence grade, and services listed. Also returns total match count, a next_cursor for pagination, query echo, data-as-of date, and disclaimer text. ## 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": [ "specialty" ], "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." }, "focus": { "enum": [ "medical", "cosmetic", "surgical" ], "type": "string", "description": "For dermatology and aesthetics: medical, cosmetic or surgical." }, "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)." }, "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": … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "count": 10, "query": { "limit": 10, "format": "concise", "location": "ZIP 85255", "specialty": "dermatology", "radius_miles": 25 }, "source": "FindMyDirectDoctor directory", "results": [ { "zip": "85260", "city": "Scottsdale", "name": "Anthony Petelin", "state": "AZ", "website": "https://www.azcdps.com/locations/scottsdale", "evidence": { "as_of": "2026-10-27", "basis": [], "grade_min": "C" }, "doctor_id": "fd_dp6jcp2xci", "label_basis": "FindMyDirectDoctor directory label, not a verified board specialty", "practice_name": "Center for Dermatology & Plastic Surgery", "distance_miles": 5.7, "practice_model": "concierge", "services_listed": [], "specialty_label": "Dermatology", "credential_class": "MD", "credentials_text": "MD", "location_precision": "zip", "board_certifications": [] }, { "zip": "85260", "city": "Scottsdale", "name": "Arun Sood", "state": "AZ", "website": "https://www.azcdps.com/locations/scottsdale", "evidence": { "as_of": "2026-10-27", "basis": [], "grade_min": "C" }, "doctor_id": "fd_er3v7sfc2y", "label_basis": "FindMyDirectDoctor directory label, not a verified board specialty", "practice_name": "Center for Dermatology & Plastic Surgery", "distance_miles": 5.7, "practice_model": "concierge", "services_listed": [], "specialty_label": "Dermatology", "credential_class": "MD", "credentials_text": "MD", "location_precision": "zip", "board_certifications": [] } ], "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": 28, "statement_basis": "Facts are shown as the practice or publisher states them. Grade A = federal registry, board or ho..." } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-specialty-directory-search-1f348bca/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)