NPI Registry

Built by John Rippy | johnrippy.link

🏆 2025 Zapier Automation Hero of the Year — Project Phoenix: A 95-step AI sales pipeline cutting development time by 50%. Read more →

Healthcare Provider Search - Find Any Provider in the US by NPI, Name, or Specialty

Search the official NPPES NPI Registry for healthcare providers, physicians, and organizations. Look up by NPI number, name, specialty, or location. Perfect for healthcare marketing, provider verification, credentialing, and medical data enrichment.

What is the NPI Registry?

The NPPES NPI Registry is the official U.S. database of all healthcare providers with National Provider Identifiers (NPIs). Maintained by CMS, it contains information on over 8 million individual and organizational providers.

Features

Provider Search

• Search Providers - Find individual healthcare providers by name, specialty, location
• Lookup NPI - Get details for a specific NPI number
• Search Organizations - Find healthcare organizations, hospitals, clinics
• Search by Specialty - Find providers by taxonomy/specialty
• Search by Location - Find providers in a specific city, state, or ZIP
• Batch Lookup - Look up multiple NPI numbers at once

Data Available

• Provider name and credentials
• Practice address and phone
• Mailing address
• Taxonomy codes (specialties)
• License information
• Authorized official (for organizations)
• Other identifiers
• Enumeration date

Use Cases

Healthcare Marketing

• Build targeted provider lists
• Verify provider information
• Enrich CRM data with NPI details

Credentialing

• Verify provider credentials
• Confirm NPI numbers
• Check specialty information

Healthcare Analytics

• Analyze provider distribution
• Track specialty trends
• Geographic analysis

Referral Networks

• Find specialists in an area
• Build referral databases
• Provider directory updates

Input Parameters

Parameter	Type	Required	Description
task	string	Yes	Operation to perform
npiNumber	string	No	Exact 10-digit NPI number
firstName	string	No	Provider first name
lastName	string	No	Provider last name
organizationName	string	No	Organization name
taxonomyDescription	string	No	Specialty/taxonomy text
city	string	No	City for location search
state	string	No	Two-letter state code
postalCode	string	No	ZIP code
enumerationType	string	No	NPI-1 (individual) or NPI-2 (organization)
npiNumbers	array	No	Array of NPIs for batch lookup
limit	integer	No	Max results (default: 50, max: 200)
skip	integer	No	Results to skip for pagination
webhookUrl	string	No	URL to send results
demoMode	boolean	No	Run with sample data (default: true)

Available Tasks

Task	Description
search_providers	Search for individual providers
lookup_npi	Look up a specific NPI number
search_organizations	Search for healthcare organizations
search_by_specialty	Find providers by specialty
search_by_location	Find providers in a location
batch_lookup	Look up multiple NPI numbers

Example Usage

Search by Name

{
  "task": "search_providers",
  "firstName": "John",
  "lastName": "Smith",
  "state": "CA",
  "limit": 50
}

Look Up Specific NPI

{
  "task": "lookup_npi",
  "npiNumber": "1234567890"
}

Search by Specialty

{
  "task": "search_by_specialty",
  "taxonomyDescription": "Cardiology",
  "state": "NY",
  "city": "New York",
  "limit": 100
}

Search Organizations

{
  "task": "search_organizations",
  "organizationName": "Memorial Hospital",
  "state": "TX",
  "limit": 50
}

Batch NPI Lookup

{
  "task": "batch_lookup",
  "npiNumbers": ["1234567890", "0987654321", "1122334455"]
}

Search by Location

{
  "task": "search_by_location",
  "city": "Los Angeles",
  "state": "CA",
  "postalCode": "90210",
  "limit": 100
}

Output

Results are saved to the default dataset:

Provider Search Results

{
  "task": "search_providers",
  "success": true,
  "result_count": 15,
  "providers": [
    {
      "number": 1234567890,
      "enumeration_type": "NPI-1",
      "basic": {
        "first_name": "JOHN",
        "last_name": "SMITH",
        "credential": "MD",
        "gender": "M",
        "enumeration_date": "2007-05-23",
        "last_updated": "2024-11-15",
        "status": "A"
      },
      "addresses": [
        {
          "address_purpose": "LOCATION",
          "address_1": "123 Medical Plaza",
          "city": "Los Angeles",
          "state": "CA",
          "postal_code": "90210",
          "telephone_number": "310-555-0100"
        }
      ],
      "taxonomies": [
        {
          "code": "207R00000X",
          "desc": "Internal Medicine",
          "primary": true,
          "state": "CA",
          "license": "A123456"
        }
      ]
    }
  ]
}

Provider Types

Enumeration Type	Description
NPI-1	Individual provider (physician, nurse, therapist, etc.)
NPI-2	Organizational provider (hospital, clinic, pharmacy, etc.)

Common Taxonomies

Specialty	Taxonomy Code
Family Medicine	207Q00000X
Internal Medicine	207R00000X
Cardiology	207RC0000X
Orthopedic Surgery	207X00000X
Pediatrics	208000000X
Psychiatry	2084P0800X
Dentist	1223G0001X
Pharmacy	333600000X

Rate Limits

The NPPES API is free and public but should be used responsibly. The actor includes built-in rate limiting.

Demo Mode

Test the actor without hitting the live API:

{
  "task": "search_providers",
  "lastName": "Smith",
  "demoMode": true
}

Pricing

Pay-per-result pricing:

Operation	Cost
Search providers	$0.02
Lookup NPI	$0.01
Search organizations	$0.02
Search by specialty	$0.02
Search by location	$0.02
Batch lookup (per NPI)	$0.01

Related Actors

• CMS Provider Data - Medicare provider data
• FDA Drug Database - Drug information

Support

• NPPES API Docs: npiregistry.cms.hhs.gov/api-page
• Issues: Report on Apify

---