NPPES NPI Registry

How to Use This API

1. Lookup by NPI Number

https://npiregistry.cms.hhs.gov/api/?version=2.1&number=1234567893

2. Search by Provider Name

https://npiregistry.cms.hhs.gov/api/?version=2.1&first_name=John&last_name=Smith

3. Search by Taxonomy Code

https://npiregistry.cms.hhs.gov/api/?version=2.1&taxonomy_description=Internal%20Medicine

4. Filter by City & State

https://npiregistry.cms.hhs.gov/api/?version=2.1&city=Chicago&state=IL&limit=10

5. JavaScript — Find Provider

async function findNPI(first, last) {
  const resp = await fetch(
    `https://npiregistry.cms.hhs.gov/api/?version=2.1&` +
    `first_name=${first}&last_name=${last}&limit=5`
  );
  const data = await resp.json();
  
  data.results.forEach(p => {
    const addr = p.addresses[0];
    console.log(`${p.basic.first_name} ${p.basic.last_name}`);
    console.log(`NPI: ${p.number}`);
    console.log(`Address: ${addr.address_1}, ${addr.city}, ${addr.state}`);
    console.log('---');
  });
}

findNPI('Emily', 'Johnson');

6. Python — Bulk Provider Search

import requests

specialties = [
    'Internal Medicine',
    'Family Medicine',
    'Pediatrics',
    'Cardiology'
]

for spec in specialties:
    resp = requests.get(
        'https://npiregistry.cms.hhs.gov/api/',
        params={
            'version': '2.1',
            'taxonomy_description': spec,
            'limit': 3
        }
    )
    data = resp.json()
    count = data['result_count']
    print(f"{spec}: {count} providers found")