# ProviderSignal Healthcare Provider Search

> ProviderSignal Healthcare Provider Search 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).

Search and filter a database of healthcare providers by state, county, ZIP, specialty, DSO/independent status, license status, and Medicaid roster enrollment with pagination.

## Facts

- Endpoint: GET https://providersignal.com/api/v1/agent/search
- 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-healthcare-provider-search-01f43c2a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7vTSAHJLvuidgtGgJaCSe

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-healthcare-provider-search-01f43c2a
```

Example prompt: Find me a list of active, independently-owned dental providers in Texas and Florida who are enrolled on the Medicaid roster — show me 25 results per page, starting with page 1, and filter by the specialty 'Dentist' using the NUCC taxonomy.

## When to prefer this

Use this endpoint when you need to search or filter U.S. healthcare providers by geographic area, specialty, license status, DSO affiliation, or Medicaid roster enrollment. It is especially valuable for credentialing workflows, network adequacy checks, Medicaid compliance research, and dental/healthcare market intelligence. Prefer this over general NPI lookup tools when multi-field filtering (e.g. state + specialty + Medicaid + license status) and pagination are required in a single call.

## Known failure modes

- Invalid or unsupported state code returns empty results or validation error
- Unrecognized NUCC taxonomy specialty string returns no matches
- Medicaid filter only covers NY and CA rosters — other states return null participation flags
- Exceeding pagination limits or passing invalid page/per_page integers may cause errors
- No matching providers for given filter combination returns empty data array
- Payment failure (x402) blocks the request before data is returned

## How this service works

Filtered provider list with pagination. Filter on state, county, ZIP, specialty, DSO/Independent, license status, Medicaid state-roster enrollment.

## Output

Returns a paginated array of provider records, each containing NPI, first and last name, city, state, specialty, and a Medicaid participation flag (true/false/null). Also includes metadata with request ID, billing method, billed credits, envelope version, and per-source data attribution including table name, license, last refresh date, and schema version. Errors are returned as a structured object with code and message.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "zip": {
   "type": "string"
  },
  "city": {
   "type": "string"
  },
  "page": {
   "type": "integer"
  },
  "state": {
   "type": "string",
   "description": "Single 2-letter code or comma-list (e.g. 'TX,FL,CA')"
  },
  "is_dso": {
   "type": "string"
  },
  "has_cms": {
   "type": "string"
  },
  "medicaid": {
   "type": "string",
   "description": "true = state-listed on a Medicaid enrolled-provider roster (NY + CA rosters currently; state-listed enrollment, not verified acceptance)"
  },
  "per_page": {
   "type": "integer"
  },
  "specialty": {
   "type": "string",
   "description": "Exact NUCC taxonomy specialty match"
  },
  "license_status": {
   "type": "string",
   "description": "Single value or comma-list of normalized buckets (active/inactive/expired/retired/deceased/disciplined/pending)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data",
  "error",
  "meta"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "npi": {
      "type": "string"
     },
     "city": {
      "type": [
       "string",
       "null"
      ]
     },
     "state": {
      "type": [
       "string",
       "null"
      ]
     },
     "last_name": {
      "type": [
       "string",
       "null"
      ]
     },
     "specialty": {
      "type": [
       "string",
       "null"
      ]
     },
     "first_name": {
      "type": [
       "string",
       "null"
      ]
     },
     "medicaid_participating": {
      "type": [
       "boolean",
       "null"
      ],
      "description": "State-listed on a Medicaid enrolled-provider roster (NY/CA so far); null = no ingested roster lists this NPI."
     }
    },
    "additionalProperties": true
   }
  },
  "meta": {
   "type": "object",
   "required": [
    "envelope_version"
   ],
   "properties": {
    "request": {
     "type": "object",
     "properties": {
      "id": {
       "type": "string"
      },
      "endpoint": {
       "type": "string"
      },
      "billed_credits": {
       "type": "integer"
      },
      "billing_method": {
       "enum": [
        "subscription",
        "per_query",
        "free",
        "admin"
       ],
       "type": "string"
      }
     }
    },
    "envelope_version": {
     "type": "string"
    },
    "source_attribution": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "table": {
        "type": "string"
       },
       "license": {
        "type": "string"
       },
       "last_refresh": {
        "type": [
         "string",
         "null"
        ]
       },
       "schema_version": {
        "type": "string"
       }
      }
     },
     "description": "Per-source citation: logical table, last successful refresh, schema version, license posture."
    }
   },
   "additionalProperties": true
  },
  "error": {
   "type": [
    "object",
    "null"
   ],
   "description": "Null on success; { code, message } on failure."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/providersignal-healthcare-provider-search-01f43c2a/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)