# ProviderSignal Medicaid Dentist Directory

> ProviderSignal Medicaid Dentist Directory is a paid API for AI agents from providersignal.com, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-14).

Returns a paginated list of state-enrolled Medicaid dentists filtered by state, city, ZIP, specialty, language, and patient-acceptance status across all 50 US states plus DC.

## Facts

- Endpoint: GET https://providersignal.com/api/v1/agent/medicaid/dentists
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/providersignal-medicaid-dentist-directory-198c1dba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GXis0RyqGQMdjKJgyU3e4

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 providersignal-medicaid-dentist-directory-198c1dba
```

Example prompt: Can you find me Medicaid dentists in Houston, TX who are accepting new patients and speak Spanish — show me up to 50 results?

## When to prefer this

Use this endpoint when you need to locate Medicaid-enrolled dental providers in any US state with optional filtering by geography (city, ZIP), clinical specialty (e.g., Pediatric, Orthodontics), patient-acceptance status, language, or special-needs accommodation. It is the right choice when you need source-cited, NPI-matched provider data drawn from official state Medicaid submissions and federal datasets. Prefer this over general provider directories when Medicaid enrollment and plan participation details are specifically required.

## Known failure modes

- Missing required 'state' query parameter returns a validation error
- Invalid state code (not a 2-letter uppercase code) returns a pattern validation error
- Unsupported or misspelled specialty/city/language values silently narrow results to zero (missing data in source, not an API error)
- 'accepting' or 'special_needs' flags may return fewer results than expected because many states never populate these fields
- Payment failure (402) if x402 USDC payment or MPP Stripe token is invalid or insufficient
- Rate limiting or auth failure if Bearer token subscription is expired or missing
- ZIP code not matching 5-digit pattern returns a validation error

## How this service works

Healthcare market intelligence API. Unified provider directory + acquisition signals + license-events feed across all 50 US states, derived from NPI + state dental boards + CMS Medicare + OIG LEIE + state Medicaid + HRSA HPSA designations. All responses ship a citation envelope (`meta.envelope_version`, `meta.source_attribution`, `meta.request`) so agents can verify source freshness without out-of-band validation. Paid `/api/v1/agent/*` endpoints accept two per-call rails on a single 402: x402 (USDC on Base mainnet) and MPP (Stripe card via a Shared Payment Token), plus Bearer-token subscription auth for existing API keys. See [/docs/agent-payments](/docs/agent-payments) for the full flow. See [/docs/fields](/docs/fields) for the field glossary and [/llms.txt](/llms.txt) for the LLM crawler index.

## Output

A JSON object containing a paginated list of Medicaid-enrolled dental provider locations for the requested state and filters. Each provider record includes name, NPI, address, city, ZIP, county, phone, specialty, Medicaid plan participation, languages spoken, accepting-new-patients flag, special-needs accommodation flag, and the date the listing was last updated. The response also includes a meta citation envelope (envelope version, source attribution, request details), a disclaimer about state-listed vs verified acceptance, the total number of matching rows, and the number of provider locations returned.

## 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": [
      "state"
     ],
     "properties": {
      "zip": {
       "type": "string",
       "pattern": "^\\d{5}$",
       "description": "Optional 5-digit ZIP filter."
      },
      "city": {
       "type": "string",
       "description": "Optional city filter (case-insensitive exact match on the listing's city)."
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "description": "Provider-locations per page (default 25, max 100). Alphabetical by provider name."
      },
      "state": {
       "type": "string",
       "pattern": "^[A-Z]{2}$",
       "description": "Required. 2-letter state code (e.g. TX, FL, CA). All 50 states + DC covered."
      },
      "language": {
       "type": "string",
       "description": "Optional language filter (e.g. Spanish, Vietnamese): substring match on the listing's languages-spoken field. Only ever narrows to positively flagged listings; many states leave the field blank."
      },
      "accepting": {
       "enum": [
        "true"
       ],
       "type": "string",
       "description": "Optional. 'true' returns only providers the state marks accepting new Medicaid patients (some states never populate the flag)."
      },
      "specialty": {
       "type": "string",
       "description": "Optional specialty substring filter (e.g. Pediatric, Orthodontics). Some states publish no specialty detail."
      },
      "special_needs": {
       "enum": [
        "true"
       ],
       "type": "string",
       "description": "Optional. 'true' returns only providers the state flags as accommodating patients with special healthcare needs. Same caveat: absence of the flag is missing data, not a refusal."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "error",
      "meta"
     ],
     "properties": {
      "data": {
       "t
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "state": "TX",
   "filters": {
    "zip": null,
    "city": "Houston",
    "language": null,
    "specialty": null,
    "accepting_only": true,
    "special_needs_only": false
   },
   "sampled": false,
   "providers": [
    {
     "zip": "77002",
     "city": "Houston",
     "name": "SMITH, JANE",
     "phone": "(713) 555-0100",
     "plans": [
      "DentaQuest (Medicaid)",
      "MCNA Dental (Medicaid)"
     ],
     "state": "TX",
     "county": "Harris County",
     "address": "123 MAIN ST",
     "specialty": "General Dentistry",
     "matched_npi": "1234567890",
     "special_needs": "Yes",
     "listing_updated": "2026-07-16",
     "languages_spoken": "Spanish, Vietnamese",
     "accepting_new_patients": "Yes"
    }
   ],
   "disclaimer": "Providers are STATE-LISTED on the program's federal submission, not verified acceptance. Always call the office to confirm participation in the specific plan.",
   "state_name": "Texas",
   "listing_rows_matching": 5104,
   "provider_locations_returned": 25
  },
  "meta": {
   "request": {
    "endpoint": "/api/v1/agent/medicaid/dentists",
    "billing_method": "per_query"
   },
   "envelope_version": "1.0"
  },
  "error": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/providersignal-medicaid-dentist-directory-198c1dba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from providersignal.com](https://www.zero.xyz/host/providersignal.com/llms.txt)
