Healthcare Provider NPI Enricher

Give NPIs or provider names and get each provider's record from the official US NPI Registry: one row per provider with taxonomy, license, practice address and phone, and, for an organization, its authorized official. You pay per provider, and Mamba Labs pays the platform costs.

Features

• Four ways in, in one run. NPIs, individual names, organization names, or a search by taxonomy, city, or postal code.
• Flat columns for Clay. Primary taxonomy, license, and practice address sit in their own columns, and the full lists stay as arrays.
• Misses are free. An NPI that fails its check digit is caught before any lookup, and an NPI or name with no record is one free row that says so.
• A provider is charged once per run, even when two lookups match the same NPI.
• match_count on provider rows, so a name that matched 40 people is easy to spot. It is null when the matches filled the page, because more may exist.
• The 1,200 limit is stated. The registry serves at most 1,200 records per search, and a search that reaches it reads partial. Nothing is cut off silently.
• Restart aware. If Apify moves the run to another host, it resumes from its saved position.

How the data is read

The actor calls the NPI Registry API run by CMS, directly. CMS publishes this data under its NPPES data dissemination notice, with no key, no sign in, and no charge. There is no scraping, no AI, and no other developer's actor. Records change daily, and each run reads them live.

Input

Field	Type	Default	What it does
npis	array		10 digit NPIs. Each returns its record. An invalid NPI or one with no record is a free row.
individual_names	array		People, as Jane Doe, Doe, Jane, or Dr. Jane Doe MD. The registry also matches common first name aliases. A trailing * after 2 or more letters is a wildcard. Add state to narrow common names.
organization_names	array		Organizations. The registry matches whole words, so add a trailing , such as kaiser, to widen the match.
taxonomy	string		Filter or search by the registry's taxonomy wording, such as cardiovascular disease, or cardio* as a wildcard. Cardiology alone matches only Pharmacist, Cardiology. Applies to names and to the search. Does not apply to NPIs.
state	string		Two letter state code. Applies to names and to the search. The registry refuses state alone, so give it with a name, taxonomy, city, or postal code.
city	string		City filter. Applies to names and to the search.
postal_code	string		5 or 9 digit postal code, with a trailing * after 2 or more digits as a wildcard.
provider_type	string	both	For the taxonomy, city, or postal code search: both (default), individual, or organization.
max_results_per_lookup	string	25	Provider rows per name or search, from 1 to 1200. Default 25. The registry serves at most 1200 records per search.
max_charge_usd	string		Optional. The run stops before a charge that would pass this amount. Summary rows are always returned.

Output

Field	Type	What it holds
row_type	string	One of: provider, lookup_summary, run_summary. run_summary is the one free row written when the input is refused.
input	string	The NPI, name, or search that produced this row.
lookup_kind	string	npi, individual, organization, or search.
npi	string	The 10 digit National Provider Identifier.
provider_type	string	individual (NPI-1) or organization (NPI-2).
status	string	The registry status. A is active.
name	string	Full name of the person or organization, as the registry holds it.
first_name	string	Individuals.
middle_name	string	Individuals.
last_name	string	Individuals.
credential	string	Individuals: the credential as entered, such as M.D.
sole_proprietor	string	Individuals: YES or NO as the registry holds it.
organization_name	string	Organizations.
authorized_official	string	Organizations: name, title, and credential of the official the registry lists.
authorized_official_phone	string	Organizations: the phone the registry lists for the official.
primary_taxonomy_code	string	The taxonomy marked primary.
primary_taxonomy	string	Description of the primary taxonomy.
primary_license	string	License number on the primary taxonomy, when given.
primary_license_state	string	State of that license.
taxonomies	array	Every taxonomy: code, desc, primary, state, license.
practice_address	string	Primary practice street lines.
practice_city	string	Primary practice city.
practice_state	string	Primary practice state.
practice_postal_code	string	Primary practice postal code.
practice_country	string	Two letter code.
practice_phone	string	The phone on the primary practice address.
practice_fax	string	The fax on the primary practice address.
mailing_address	string	The mailing address on one line.
practice_locations	array	Further practice addresses in the registry.
other_identifiers	array	Other identifiers the provider listed: code, desc, identifier, issuer, state.
other_names	array	Other names on the record.
endpoints	array	Electronic exchange endpoints the provider published.
enumeration_date	string	When the NPI was issued.
last_updated	string	When the record last changed.
registry_url	string	The record on the NPI Registry.
match_count	integer	Records this lookup matched, when they fit on one page. Null when more may exist. Above 1 on a name lookup means check the row before relying on it.
matches_read	integer	lookup_summary: records read for this lookup.
rows_returned	integer	lookup_summary: provider rows written for this lookup.
duplicates_skipped	integer	lookup_summary: records already returned earlier in this run, not charged again.
row_status	string	ok, or why this row carries no data: no_results, no_change, partial, blocked, or error.
error_reason	string	Why the row is not ok. A refused input reads input_invalid: followed by what to fix.
billable_events_json	string	What this row was billed as, for example {"provider-row":1}. {} means free.
scraped_at	string	When the row was written, UTC.

Pricing

Pay per event. Lookup summaries, NPIs not found, invalid NPIs, and refused input are free.

Event	Free plan	Bronze	Silver	Gold
provider-row, one provider record	$0.002	$0.0019	$0.0018	$0.0017
apify-actor-start, once per run (one per GB of memory; the default 256 MB is one)	$0.002	$0.002	$0.002	$0.002

Per 1,000 rows of provider-row: $2.00 on the free plan, $1.70 on Gold.

Free plan cap: 1.50 USD of evaluation a month, about 750 rows. Any paid Apify plan removes the cap, and it resets on the 1st. The run stops before a charge that passes your maximum charge per run in Apify or your max_charge_usd input.

Mamba Labs pays the platform costs of your run, Apify proxy traffic included.

Usage examples

Enrich a list of NPIs.

{
  "npis": ["1003000126", "1740362904"]
}

Find a person, narrowed by state.

{
  "individual_names": ["Jane Doe", "Doe, John"],
  "state": "CA",
  "max_results_per_lookup": "5"
}

Search by taxonomy and city.

{
  "taxonomy": "cardiovascular disease",
  "city": "Boston",
  "state": "MA",
  "provider_type": "individual",
  "max_results_per_lookup": "200"
}

Clay. Number inputs are text fields, which is what Clay sends. A list input takes a JSON list, so put the column inside a one item list.

MCP. The Mamba Labs MCP server @mambalabsdev/mcp-healthcare-provider-npi-enricher exposes this actor to Claude and other MCP clients.

Limitations

• Rows hold only what the registry publishes, as providers entered it. There is no personal email, and this actor does not look for one. Gender is in the registry and is left out of the rows.
• A practice or mailing address can be a provider's own, and a phone can be out of date. Providers keep these records themselves.
• No Medicare enrollment flag: the registry does not publish one. other_identifiers shows the identifiers a provider chose to list.
• A name lookup matches every person with that name. Check match_count, and narrow with state, city, or taxonomy. A name alone cannot prove a row is the person you mean.
• taxonomy matches the registry's own wording, not the common name of a specialty. In testing, cardiology in Boston returned 6 records, all Pharmacist, Cardiology, because cardiologists are filed under Cardiovascular Disease. cardio* returned the wider set. Read primary_taxonomy on the rows.
• An organization name also matches the record's other names, so kaiser* can return a provider whose legal name does not contain it.
• A list of mostly misses stops: after more than 5 free rows, plus 50 for each provider row, the run writes a free row saying how many lookups were not read. Run the rest after checking the list.
• The registry serves at most 1,200 records per search, and this actor does not split a search to pass that. Run one search per state or city for more.
• Every record read in testing had status A. A no_results row on an NPI can mean it was never issued or is no longer served, and the actor cannot tell which.
• US providers only, because the registry covers those holding an NPI.

Mamba Labs actor suite

Actor	Actor ID
Account Hiring Watch	gRAZA5WBi1r6L0gy7
Agent Accessibility Auditor	anxbRv0lKrpQ1pnua
Agent to Brokerage Resolver	ePRRGLxOGyaVHO4dI
AI Answer Visibility Tracker	RJZvzKniYK4nswcMg
AI Tooling Detector	EwkHhmqiuJgRoVEbE
Amazon Product, Price, and Stock Tracker	MtJPZoyjJ3IeqTFyo
API Deprecation and Breaking Change Monitor	pHsbS3xXUK8Jqutz5
App Store and Google Play Review Monitor	MaCMEhGrbchxQZ92G
B2B Reddit Conversation Monitor	SoDryzzsjmY3SsiyG
Bluesky Brand Presence Mapper	eLpxzP4IuXznlFVND
Brand Sponsor Finder	PPgK6xrgOmvL7Nrys
Bulk WHOIS and RDAP Domain Age Lookup	MTrkG5FLU6SjqLdJY
Career Change Signal Engine	vX2Yga1a6wGaXaP14
Company Careers Page Jobs, 17 ATS Boards	izP0rfIgf5YaRZfIh
Company Change Event Feed	oX44rS0fkEJ3rXLWe
Company Discovery List Builder	jch0HdaZnpbMqlcGS
Company Firmographic Enricher	YlUtLWjfPpqykmB8g
Company Funding Record	OFS4Mt1gyYNtGfUbE
Company Headcount Estimator	aHC4GROnNt6kfZe5r
Company Identity Resolver	lr8fTRAmZCBZmuwwh
Company Role Email, Phone and Address Finder	4mMncKaJykiq94grz
Company Social Presence Mapper	4k6CCemkgBDz18m2h
Competitor Price, Stock, and Changelog Monitor	yxdgCbUQ4PYQWwRNU
Contact Classifier	0lGSeYJmniXhGANnO
Contractor License Search, CA, TX, WA, OR, LA	WBYK3CPI2kdeq4bP1
CRM Contact Job Change Checker	L8UbEmMJC1XYPSZOb
Domain Deliverability Checker	0tVgxI7A6o9jMlxmc
Domain to LinkedIn URL Resolver	3HtnSaqPHOg1Qg5gx
Ecommerce Platform Profiler	5G2NeYjBbQTjaTn9L
Ecommerce Store Discovery	PeHu4sLyFvQHXUUrX
Email List Verifier, Bring Your Own Key	CzVJ4NlaCKk80xpgE
Event Presence Index	WLhMy8fMDgsxdYxv5
Expert Witness Finder, US and Australia	LIpwlgfE3LaQBaXd4
Funding and Press Signal Scanner	FS13X6dhQVgX3XOM6
GDPR Cookie Banner and Consent Checker	TrKyOS0KBoGC35nbr
GitHub Followers and Following Export	SGNxDmFb9v3tRDaFI
GitHub Organization Signal Scanner	ahF8RRpv5mzPao5CN
Google Ads Transparency Center Scraper by Domain	1eOwxhBVxzvOXAm4s
Google Trends Scraper	OeDzaACKmBYJXzHZk
GTM Hiring Signal Scraper	D7O1SA2EqwHGsGr1P
GTM Signals Aggregator	xKdRfnfFNkdMpFuNs
Healthcare Provider NPI Enricher	MrgbHzcpDq3mOv9Df
ICP Fit Scorer	W161DT8W4kW55dMFh
Influencer Change Monitor	d2VVgahNL6UmcLkhg
Influencer Lead List Builder	KnmByszcv135yM30G
Influencer Profile Scraper	EqEnklDVMIcB1V499
Influencer Search Across TikTok, Instagram and YouTube	tpkedmloIIWtXx6sg
Influencer Talent Agency Lookup	zCuX4Mgyg6JvXgGzd
Instagram Facebook Brand Presence Mapper	HXh65I0JBjPsunbY8
Integration and Marketplace Presence Mapper	V0guNuvM85Q61f2gj
Job Board Keyword Signal Scanner	4DvqpvhMR74NLcDDY
Job Posting Monitor	QCfICD9kOPiOdj5iI
Journalist and Media List Builder	mAfizsZC8qRoR0ecS
Launch Directory List Builder	cRq3bmvEZxZtioQ7U
Lead File Import Checker	RwlGVXTf46LqZdUgt
Legal Entity Resolver	KHFyPCDIx7CyqULYm
Link in Bio Scraper and Newsletter Detector	OorucdheTIgu7RFzK
LinkedIn Company Page Mapper	zOPm6A9JEhUGcIdFW
LinkedIn Jobs Feed	SH6N0d8cz46BhCC8B
LinkedIn Post Tracker	oiGLNPuaf5BRaz9K5
Local Business Lead Builder	qMN97aoHhsAS5bznV
Local Rank and Map Pack Tracker	gv0kyHGDIg8XscclB
Lookalike Companies from Seed Domains	e2O426WBAbLLQL4Z2
Manufacturer and Supplier Finder	Qcsdmd0lUfPzVkonh
MCP Server Change and Health Monitor	IeqjWF9U0BdDQFY08
Media URL Transcriber	Syfr7Ya3EsHgWfrB6
Meta Ad Library Ads by Company, Graph API	J1GWlSXfSGU3u8Wng
Mobile Phone Waterfall	6OOgPktf7RIa5XCOP
New Hire Finder	cKuc38p4nYHNF3IW8
Newly Registered Companies, UK, Norway, Finland, France	g2WfZhWvCtc57g2Jo
News and Media Mention Monitor	gol1PPUKrsIk4QLBd
Newsletter Sponsor Tracker	qSwpqxD1TiPZpLQHv
Open Tender and RFP Finder	kPTGz6t6TFoUUyfaO
Outbound Stack Detector	v43UJC8r7qW7cBSTG
Page Finder and Extractor	TpurgcOZbVnknlaiC
Partner and Member Directory Extractor	ZX0XJPPUvnFJxeC1a
People Finder & Email Verifier	LEgloG7tWgQl4o6TD
Person LinkedIn URL Resolver	ssuyPV8LnEsL8qbnb
Person Social Footprint Mapper	jfQXa2zW9FHCJot9K
Personal Email to Company Resolver	AefT5Ye6YNPFQwJBf
Pinterest Brand Presence Mapper	d1HvjZfKhgvWsoEwn
Podcast Guest and Host Finder	o2MGSvgbSLeeXOsIo
Product Hunt Daily Launches with Maker Domains	O4VX63drWK9Y9x641
Prospect Engine	q9rT6v64nUJdPexOQ
Public Feature Board and Roadmap Monitor	rcHF5gj5r2Vqnry35
Publishing Frequency Tracker	TbLwaUUATdYb6wp4N
Recent Funding Rounds Feed	KueVp9MOz7iOoAgDp
Reddit Brand Presence Mapper	pKQZmDaT70SEb54bZ
Reddit Search and Thread Scraper	4Gsth5cP2Xt9V2xDN
Reporting Window Finder	uINxR7a1IW8qUTRUX
Research Topic Institutions and Authors	OH8ANqt7bCKbo72Gk
Sequencer Event Poller	S6s8Rjd61tGdrMRk4
Sequencer Lead Push	0Jv27VeWM5tSZQs9x
Shopify App Store and Chrome Web Store Listings	gaY0BzkLyN77mD3wI
Site Crawler for Links and Tables	lLLJ6JxZ4XqN8ULz0
Substack Newsletter and Posts Scraper	UEFsdwiPLmPNVy9xd
Team Page People Extractor	j8a9zX0k4mNbvDbWK
Tech Stack Signal Detector	qyd7nNyqFPelQViBx
Threads Posts by Keyword, Exact Match	2OT8K8RiEEWtaj2MW
TikTok Brand Presence Mapper	fco8FvoJcSafbeyd1
Trustpilot Reputation Enricher	3lIqfCt61j4hqE1xz
US and UK Contract Award Winners by Company	zhEtllASykOcx9hJ8
US Import Records Buyer Finder	VIMafpKF5ggOw0COU
VC and Accelerator Portfolio List Builder	chH8hrfuoqqolW06m
Website Accessibility Checker, WCAG 2.2 AA	P3jBj3FRghKEhX52z
Website Phrase and Business Model Classifier	CBuZ9k7sRwBeiKiCS
Website Traffic Rank Estimator	GnOFUzlNVIoXgeJjH
Work Email Waterfall	OT6xqTFThC0Rjf7Zj
Workplace Program Detector	Li6pPDhqbdzFz3h7G
X Brand Presence Mapper	oLOgadhHUkNAyDA3w
YouTube Channel from Company Domain	6hSpD3kd2s2IQ4VSs
Zillow Listing Details	yG4zM0Enfsw2NefJ1

Built by Mamba Labs.