B2B healthcare lead extractor and enricher for US doctors, dentists, clinics, and hospitals using the official CMS NPPES NPI Registry API v2.1. Extracts NPI-1 and NPI-2 records, practice addresses, phone numbers, primary taxonomy, state licenses, and AI-ready lead dossiers. ### Enterprise B2B Value Proposition (US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API)) - **Target B2B Buyers:** MedTech Sales Teams, Healthcare CRMs, Credentialing Platforms, and Digital Health Directories. - **Zero External API Keys Required:** Connects directly to authoritative government, regulatory, and financial primary registries with built-in retry/backoff and deterministic schema normalization. - **Quantitative Scoring & RAG Briefs:** Every record is enriched with a quantitative 0-100 risk/viability score and an LLM-ready Markdown executive brief (`US NPI Healthcare Provider Lead Enriched`). - **Backend Proxy Secret Injection:** RapidAPI Studio and Zyla API Hub inject `Authorization: Bearer <TOKEN_REDACTED>` invisibly at the proxy layer when forwarding synchronous calls to `https://api.apify.com/v2/acts/b2b-quant-apis~us-healthcare-npi-provider-lead-enricher/run-sync-get-dataset-items`. - **Marketplace Categories:** RapidAPI `Medical` | Zyla API Hub `Healthcare`. - **Subscription Tiers (USD):** `BASIC` ($0.00/mo, 15 req/mo hard cap), `PRO` ($19.00/mo, 1,000 req/mo + $0.02/extra), `ULTRA` ($49.00/mo, 5,000 req/mo + $0.015/extra), `MEGA` ($149.00/mo, 25,000 req/mo + $0.010/extra). - **SEO Keywords:** npi-registry, nppes-cms, healthcare-leads, medical-providers, doctor-lookup, hipaa-kyb, pharma-crm.
B2B healthcare lead extractor and enricher for US doctors, dentists, clinics, and hospitals using the official CMS NPPES NPI Registry API v2.1. Extracts NPI-1 and NPI-2 records, practice addresses, phone numbers, primary taxonomy, state licenses, and AI-ready lead dossiers. ### Enterprise B2B Value Proposition (US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API)) - **Target B2B Buyers:** MedTech Sales Teams, Healthcare CRMs, Credentialing Platforms, and Digital Health Directories. - **Zero External API Keys Required:** Connects directly to authoritative government, regulatory, and financial primary registries with built-in retry/backoff and deterministic schema normalization. - **Quantitative Scoring & RAG Briefs:** Every record is enriched with a quantitative 0-100 risk/viability score and an LLM-ready Markdown executive brief (`US NPI Healthcare Provider Lead Enriched`). - **Backend Proxy Secret Injection:** RapidAPI Studio and Zyla API Hub inject `Authorization: Bearer <TOKEN_REDACTED>` invisibly at the proxy layer when forwarding synchronous calls to `https://api.apify.com/v2/acts/b2b-quant-apis~us-healthcare-npi-provider-lead-enricher/run-sync-get-dataset-items`. - **Marketplace Categories:** RapidAPI `Medical` | Zyla API Hub `Healthcare`. - **Subscription Tiers (USD):** `BASIC` ($0.00/mo, 15 req/mo hard cap), `PRO` ($19.00/mo, 1,000 req/mo + $0.02/extra), `ULTRA` ($49.00/mo, 5,000 req/mo + $0.015/extra), `MEGA` ($149.00/mo, 25,000 req/mo + $0.010/extra). - **SEO Keywords:** npi-registry, nppes-cms, healthcare-leads, medical-providers, doctor-lookup, hipaa-kyb, pharma-crm.
Every transaction executed by us-healthcare-npi-provider-lead-enricher produces verifiable event envelopes designed for high-stakes regulatory auditing, ERP master data synchronization, and automated continuous compliance workflows.
Detailed specification of data contracts, domain types, and primary source semantics enforced by us-healthcare-npi-provider-lead-enricher:
state (string) • OptionalTwo-letter US State code (e.g., FL, NY, CA, TX).
city (string) • OptionalOptional city filter (e.g., Miami, Orlando, Los Angeles).
taxonomyDescription (string) • OptionalSpecialty/Taxonomy e.g. Dentist, Dermatology, Internal Medicine, Physical Therapist.
enumerationType (string) • OptionalFilter by Individual Providers (NPI-1), Organizations/Clinics (NPI-2), or All.
postalCode (string) • OptionalOptional US ZIP code prefix (e.g., 331, 33131).
maxResults (integer) • OptionalMaximum number of healthcare provider leads to extract and enrich (1 to 200).
npiNumber (string)NPI Number
providerType (string)Provider Type
fullNameOrOrgName (string)Full Name / Organization
primarySpecialty (string)Primary Specialty
LicenseNumber (string)State License Number
city (string)City
state (string)State
phone (string)Direct Phone
addressLine (string)Practice Address
leadQualityScore (integer)Lead Quality Score (0-100)
markdownLeadCard (string)Markdown Lead Dossier
enumerationType (string)enumerationType returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API).
credential (string)credential returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API).
taxonomyCode (string)taxonomyCode returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API).
licenseNumber (string)licenseNumber returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API).
licenseState (string)licenseState returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API).
postalCode (string)postalCode returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API).
fax (string)fax returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API).
authorizedOfficial (string)authorizedOfficial returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API).
status (string)status returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API).
lastUpdated (string)lastUpdated returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API).
extractedAt (string)extractedAt returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API).
Stateless payload attributes validated by JSON Schema and OpenAPI 3.0.3 standards for us-healthcare-npi-provider-lead-enricher.
| Field | Type | Requirement | Description & Audit Rules |
|---|---|---|---|
state | string | Optional | Two-letter US State code (e.g., FL, NY, CA, TX). |
city | string | Optional | Optional city filter (e.g., Miami, Orlando, Los Angeles). |
taxonomyDescription | string | Optional | Specialty/Taxonomy e.g. Dentist, Dermatology, Internal Medicine, Physical Therapist. |
enumerationType | string | Optional | Filter by Individual Providers (NPI-1), Organizations/Clinics (NPI-2), or All. |
postalCode | string | Optional | Optional US ZIP code prefix (e.g., 331, 33131). |
maxResults | integer | Optional | Maximum number of healthcare provider leads to extract and enrich (1 to 200). |
Primary attributes returned in the audit response envelope with cryptographic audit metadata for us-healthcare-npi-provider-lead-enricher.
| Attribute | Type | Definition & Source Verifiability |
|---|---|---|
npiNumber | string | NPI Number |
providerType | string | Provider Type |
fullNameOrOrgName | string | Full Name / Organization |
primarySpecialty | string | Primary Specialty |
LicenseNumber | string | State License Number |
city | string | City |
state | string | State |
phone | string | Direct Phone |
addressLine | string | Practice Address |
leadQualityScore | integer | Lead Quality Score (0-100) |
markdownLeadCard | string | Markdown Lead Dossier |
enumerationType | string | enumerationType returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API). |
credential | string | credential returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API). |
taxonomyCode | string | taxonomyCode returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API). |
licenseNumber | string | licenseNumber returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API). |
licenseState | string | licenseState returned by US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API). |
Edit parameters in the request payload below and click Execute Sandbox Request to inspect the verified live schema response and dynamic cURL command.
curl -X POST "https://jesleytassili-glitch.github.io/v1/execute" \
-H "Content-Type: application/json" \
-H "X-RapidAPI-Key: YOUR_API_KEY" \
-d '{
"state": "FL",
"city": "Miami",
"taxonomyDescription": "Dentist",
"enumerationType": "ALL",
"postalCode": "",
"maxResults": 10
}'
{
"npiNumber": "1104969039",
"providerType": "NPI-2 (Organization)",
"enumerationType": "NPI-2",
"fullNameOrOrgName": "183 DENTAL GROUP, PA",
"credential": "N/A",
"primarySpecialty": "Dentist, General Practice",
"taxonomyCode": "1223G0001X",
"LicenseNumber": "DN 12408",
"licenseNumber": "DN 12408",
"licenseState": "FL",
"city": "MIAMI",
"state": "FL",
"postalCode": "33169-4470",
"phone": "305-652-8338",
"fax": "305-653-5807",
"addressLine": "636 NW 183RD ST",
"authorizedOfficial": "TODD SMITH (dentist)",
"status": "Active",
"lastUpdated": "2008-06-13",
"leadQualityScore": 100,
"markdownLeadCard": "### 183 DENTAL GROUP, PA (NPI: 1104969039)\n- **Type:** NPI-2 (Organization) | **Specialty:** Dentist, General Practice (`1223G0001X`)\n- **State License:** `DN 12408` (FL) | **Lead Score:** 100/100\n- **Practice Address:** 636 NW 183RD ST, MIAMI, FL 33169-4470\n- **Direct Phone:** 305-652-8338 | **Fax:** 305-653-5807",
"extractedAt": "2026-11-03T21:16:47.797009+00:00"
}
Direct extraction captured from primary government or corporate registry endpoints for us-healthcare-npi-provider-lead-enricher.
{
"npiNumber": "1104969039",
"providerType": "NPI-2 (Organization)",
"enumerationType": "NPI-2",
"fullNameOrOrgName": "183 DENTAL GROUP, PA",
"credential": "N/A",
"primarySpecialty": "Dentist, General Practice",
"taxonomyCode": "1223G0001X",
"LicenseNumber": "DN 12408",
"licenseNumber": "DN 12408",
"licenseState": "FL",
"city": "MIAMI",
"state": "FL",
"postalCode": "33169-4470",
"phone": "305-652-8338",
"fax": "305-653-5807",
"addressLine": "636 NW 183RD ST",
"authorizedOfficial": "TODD SMITH (dentist)",
"status": "Active",
"lastUpdated": "2008-06-13",
"leadQualityScore": 100,
"markdownLeadCard": "### 183 DENTAL GROUP, PA (NPI: 1104969039)\n- **Type:** NPI-2 (Organization) | **Specialty:** Dentist, General Practice (`1223G0001X`)\n- **State License:** `DN 12408` (FL) | **Lead Score:** 100/100\n- **Practice Address:** 636 NW 183RD ST, MIAMI, FL 33169-4470\n- **Direct Phone:** 305-652-8338 | **Fax:** 305-653-5807",
"extractedAt": "2026-11-03T21:16:47.797009+00:00"
}
import requests
url = "https://jesleytassili-glitch.github.io/specs_openapi_31/us-healthcare-npi-provider-lead-enricher.json" # Direct spec
endpoint = "https://api.apify.com/v2/acts/b2b-quant-apis~us-healthcare-npi-provider-lead-enricher/run-sync-get-dataset-items"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN" # RapidAPI or Apify Token
}
payload = {
"state": "FL",
"city": "Miami",
"taxonomyDescription": "Dentist",
"enumerationType": "ALL",
"postalCode": "",
"maxResults": 10
}
response = requests.post(endpoint, json=payload, headers=headers, timeout=60)
print(f"Status Code: {response.status_code}")
data = response.json()
print("Audit Records Count:", len(data) if isinstance(data, list) else 1)
// Node.js 18+ Native Fetch or MCP CLI
import fetch from "node-fetch";
const payload = {
"state": "FL",
"city": "Miami",
"taxonomyDescription": "Dentist",
"enumerationType": "ALL",
"postalCode": "",
"maxResults": 10
};
const response = await fetch("https://api.apify.com/v2/acts/b2b-quant-apis~us-healthcare-npi-provider-lead-enricher/run-sync-get-dataset-items", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer " + process.env.B2B_API_TOKEN
},
body: JSON.stringify(payload)
});
const result = await response.json();
console.log("Verified Records:", result);
// Or run directly via MCP CLI:
// npx -y b2b-compliance-mcp-cli execute --server us-healthcare-npi-provider-lead-enricher --payload '{"state": "FL", "city": "Miami", "taxonomyDescription": "Dentist", "enumerationType": "ALL", "postalCode": "", "maxResults": 10}'
curl -X POST "https://api.apify.com/v2/acts/b2b-quant-apis~us-healthcare-npi-provider-lead-enricher/run-sync-get-dataset-items" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{"state": "FL", "city": "Miami", "taxonomyDescription": "Dentist", "enumerationType": "ALL", "postalCode": "", "maxResults": 10}'
name: Daily Compliance Audit - us-healthcare-npi-provider-lead-enricher
on:
schedule:
- cron: '0 8 * * 1-5' # Monday to Friday at 08:00 UTC
workflow_dispatch:
jobs:
audit:
runs-on: ubuntu-latest
steps:
- name: Trigger Audit Run
run: |
curl -f -s -X POST "https://api.apify.com/v2/acts/b2b-quant-apis~us-healthcare-npi-provider-lead-enricher/run-sync-get-dataset-items" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${{ secrets.B2B_API_TOKEN }}" \
-d '{"state": "FL", "city": "Miami", "taxonomyDescription": "Dentist", "enumerationType": "ALL", "postalCode": "", "maxResults": 10}' > audit_output.json
- name: Archive Compliance Evidence
uses: actions/upload-artifact@v4
with:
name: us-healthcare-npi-provider-lead-enricher-evidence
path: audit_output.json
| HTTP Status | Classification | Resolution Behavior for us-healthcare-npi-provider-lead-enricher |
|---|---|---|
200 OK |
Success | Query executed successfully; validated US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API) records returned. |
400 Bad Request |
Schema Validation | Payload missing required fields or format mismatch for us-healthcare-npi-provider-lead-enricher; inspect JSON schema. |
401 / 403 Forbidden |
Authentication Failure | Invalid proxy API key or direct unauthorized bypass attempt for US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API). |
429 Too Many Requests |
Rate Limit Exceeded | Tier limits triggered for us-healthcare-npi-provider-lead-enricher; inspect Retry-After response header. |
502 Upstream Resilient |
Graceful Degradation | Upstream regulatory portal offline; returns safe empty set with $0 billed fee. |
healthcare-tiss-xml-validator) • [Markdown Guide]us-clinical-trials-biotech-radar) • [Markdown Guide]us-fda-recalls-safety-monitor) • [Markdown Guide]