NPI Registry - Healthcare Provider Search & Verification

Search the NPPES NPI Registry for healthcare providers, physicians, and organizations. Look up by NPI number, name, specialty, location, or organization. Get provider credentials, practice addresses, phone numbers, taxonomy codes (specialties), and license information. Perfect for healthcare marketing, provider verification, credentialing, and medical data enrichment. No API key required - uses the free CMS NPI Registry API.

Features

• Provider Search - Find individual healthcare providers by name, specialty, location
• NPI Lookup - Get details for a specific 10-digit NPI number
• Organization Search - Find healthcare organizations, hospitals, clinics, practices
• Specialty Search - Find providers by taxonomy code or specialty description
• Location Search - Find providers in a specific city, state, or ZIP code
• Batch Lookup - Look up multiple NPI numbers in one run
• Complete Provider Data - Names, credentials, addresses, phones, specialties, licenses
• Pagination Support - Handle large result sets with skip/limit
• Webhook Support - Async delivery for automation pipelines
• Demo Mode - Test with sample data before going live
• No API Key Required - Free access to CMS NPI Registry

Who Should Use This Actor?

Healthcare Marketing Teams

Build targeted provider lists for medical device, pharmaceutical, or healthcare service marketing. Find physicians by specialty and location.

Credentialing Departments

Verify provider credentials, NPI numbers, and specialty information during the credentialing process. Automate verification workflows.

Healthcare Analytics Companies

Analyze provider distribution, specialty trends, and geographic coverage. Build comprehensive healthcare databases.

Medical Billing Teams

Verify NPI numbers and provider information for claims processing. Ensure accurate provider data before billing.

Referral Network Builders

Find specialists in specific areas to build referral networks. Create provider directories for health systems.

Health Tech Companies

Enrich patient or provider records with verified NPI data. Build features requiring provider lookup functionality.

Quick Start

Demo Mode (Free Test)

{
  "demoMode": true
}

Lookup Single NPI

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

Search Providers by Name

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

Search by Specialty

{
  "task": "search_by_specialty",
  "taxonomyDescription": "Internal Medicine",
  "city": "Los Angeles",
  "state": "CA",
  "limit": 100,
  "demoMode": false
}

Search Organizations

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

Search by Location

{
  "task": "search_by_location",
  "city": "Chicago",
  "state": "IL",
  "postalCode": "60601",
  "limit": 100,
  "demoMode": false
}

Batch NPI Lookup

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

Input Parameters

Parameter	Type	Default	Description
task	string	-	Operation: lookup_npi, search_providers, search_organizations, search_by_specialty, search_by_location, batch_lookup
npiNumber	string	-	10-digit NPI number (for lookup_npi)
npiNumbers	array	-	Array of NPI numbers (for batch_lookup)
firstName	string	-	Provider first name
lastName	string	-	Provider last name
organizationName	string	-	Organization name
taxonomyDescription	string	-	Specialty/taxonomy text
city	string	-	City for location search
state	string	-	Two-letter state code
postalCode	string	-	ZIP code
enumerationType	string	-	NPI-1 (individual) or NPI-2 (organization)
limit	number	50	Max results (max 200)
skip	number	0	Results to skip for pagination
demoMode	boolean	true	Return sample data for testing
webhookUrl	string	-	Webhook URL for results delivery

Common Taxonomy Codes (Specialties)

Code	Specialty
207R00000X	Internal Medicine
207Q00000X	Family Medicine
208600000X	Surgery
207V00000X	Obstetrics & Gynecology
2084N0400X	Psychiatry
1223G0001X	Dentist
163W00000X	Registered Nurse
152W00000X	Optometrist
183500000X	Pharmacist
207X00000X	Orthopedic Surgery

Output Format

{
  "task": "search_providers",
  "success": true,
  "resultCount": 15,
  "providers": [
    {
      "number": 1234567890,
      "enumerationType": "NPI-1",
      "basic": {
        "firstName": "JOHN",
        "lastName": "SMITH",
        "middleName": "A",
        "credential": "MD",
        "gender": "M",
        "enumerationDate": "2007-05-23",
        "lastUpdated": "2025-11-15",
        "status": "A",
        "namePrefix": "DR.",
        "nameSuffix": null
      },
      "addresses": [
        {
          "addressPurpose": "LOCATION",
          "address1": "123 Medical Plaza",
          "address2": "Suite 400",
          "city": "Los Angeles",
          "state": "CA",
          "postalCode": "90210",
          "countryCode": "US",
          "telephoneNumber": "(310) 555-0100",
          "faxNumber": "(310) 555-0101"
        },
        {
          "addressPurpose": "MAILING",
          "address1": "PO Box 1234",
          "city": "Los Angeles",
          "state": "CA",
          "postalCode": "90210"
        }
      ],
      "taxonomies": [
        {
          "code": "207R00000X",
          "description": "Internal Medicine",
          "primary": true,
          "state": "CA",
          "license": "A123456"
        },
        {
          "code": "207RC0000X",
          "description": "Cardiovascular Disease",
          "primary": false,
          "state": "CA",
          "license": "A123456"
        }
      ],
      "identifiers": [
        {
          "identifier": "12345",
          "state": "CA",
          "issuer": "BCBS"
        }
      ]
    }
  ],
  "searchedAt": "2026-01-28T10:30:00.000Z"
}

Pricing (Pay-Per-Event)

Event	Description	Price
npi_lookup	Per single NPI lookup	$0.01
provider_search	Per search query	$0.02
organization_search	Per organization search	$0.02
specialty_search	Per specialty search	$0.02
location_search	Per location search	$0.02
batch_lookup	Per NPI in batch (bulk rate)	$0.01

Example costs:

• 10 NPI lookups: 10 x $0.01 = $0.10
• 50 provider searches: 50 x $0.02 = $1.00
• Batch lookup (100 NPIs): 100 x $0.01 = $1.00
• Demo mode: $0.00

No external API key required - uses free CMS NPI Registry API

Common Scenarios

Scenario 1: Build Specialist List

{
  "task": "search_by_specialty",
  "taxonomyDescription": "Orthopedic Surgery",
  "state": "FL",
  "limit": 200,
  "webhookUrl": "https://hooks.zapier.com/...",
  "demoMode": false
}

Find all orthopedic surgeons in Florida for marketing outreach.

Scenario 2: Credential Verification

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

Verify provider credentials and license information.

Scenario 3: Batch Provider Verification

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

Verify multiple NPIs from a billing or claims file.

Webhook & Automation Integration

Zapier / Make.com / n8n

1. Create a webhook trigger in your automation platform
2. Copy the webhook URL to webhookUrl
3. Route provider data to CRM, spreadsheets, or databases

Popular automations:

• Provider list -> Google Sheets (marketing database)
• Verified NPIs -> Salesforce (credentialing workflow)
• Specialty search -> Airtable (referral network)
• Location data -> Map application (provider finder)

Apify Scheduled Runs

Schedule monthly provider list updates.

FAQ

Q: Is this data accurate and official?

A: Yes. This actor queries the official CMS NPPES NPI Registry, which is the authoritative source for NPI data in the United States.

Q: Do I need an API key?

A: No. The CMS NPI Registry API is free and doesn't require authentication.

Q: What's the difference between NPI-1 and NPI-2?

A: NPI-1 is for individual providers (doctors, nurses, therapists). NPI-2 is for organizations (hospitals, clinics, group practices).

Q: How current is the data?

A: The NPI Registry is updated in real-time as providers submit changes. Use lastUpdated field to see when a record was last modified.

Q: Can I search by taxonomy code instead of description?

A: Yes. Use the taxonomyDescription parameter with either the code (e.g., "207R00000X") or description (e.g., "Internal Medicine").

Common Problems & Solutions

"No providers found"

• Check spelling of names
• Try broader search (state only, not city)
• Use partial name matches
• Verify taxonomy codes are correct

"Too many results"

• Add more specific filters (city, ZIP)
• Use pagination with skip and limit
• Narrow taxonomy/specialty

"NPI not found"

• Verify the NPI is exactly 10 digits
• The provider may have deactivated their NPI
• Check for typos in the number

"Demo data showing"

• Set demoMode: false - no API keys required

---

📞 Support

• Actor Arsenal: Full Actor Catalog
• Developer: John Rippy

---

Built by John Rippy | Actor Arsenal