Feature Overview
We’re making it easier and quicker to create signing doctors, referral doctors, and organizations in the US by using the NPI. This feature automatically fetches details like name, address, and specialty, reducing manual entry and errors.
Use Cases
Doctor Joins a Hospital Network
A busy hospital needs to onboard a new specialist who will be referring patients. Normally, this means digging through paperwork, manually entering details, and double-checking everything for errors. But with NPI lookup, the admin just enters the NPI number, and the system instantly fills in the doctor’s name, specialty, and address—saving time and avoiding typos.
Urgent Need to Add a Partner Clinic
A diagnostic lab gets a last-minute request from a new clinic that wants to start sending patient samples immediately. Instead of wasting time tracking down their details, the lab enters the clinic’s NPI number, and the system automatically pulls in the correct name and address. No back-and-forth emails, no delays—just instant onboarding and a smooth start to the partnership.
Key Features
For Referrals – Enter the NPI number, and the system auto-fills the referral doctor’s details.
For Signing Doctors – Enter the NPI number, and the system auto-fills the signing doctor’s details.
For Organizations – Enter the NPI number, and the system auto-fills the organization’s details, including name and address.
Why It’s Useful
Saves Time – No more manual data entry; just enter the NPI number.
Reduces Errors – Automatically populated details ensure accuracy.
Streamlines Integrations – The API allows external systems to fetch NPI data directly.
How to Use?
How It Works?
When adding a referral doctor, signing doctor, or organization, enter their NPI number.
The system will instantly fetch details like name, address, and other details.
The API can be used to automate this process within third-party systems.
Mapped data fields ensure seamless integration into existing workflows.
API Details
The NPPES Read API allows developers to retrieve National Provider Identifier (NPI) data.
Important Update:
API versions 1.0 and 2.0 are retired.
Only version 2.1 is active.
Old API links will no longer work.
Use the new API link: https://npiregistry.cms.hhs.gov/api/?version=2.1
If you have questions, contact NPIFiles@cms.hhs.gov.
API Usage
1. Query Limits
Maximum 200 results per request.
Use the
skipfield to skip up to 1000 records.Total limit: 1,200 records (over 6 requests).
2. Query Paramters
| Parameter | Description |
|---|---|
version | API version (2.1) |
number | 10-digit NPI of the provider |
enumeration_type | Filter by Individual (NPI-1) or Organization (NPI-2) |
taxonomy_description | Search by provider specialty |
name_purpose | Filter by Authorized Official (AO) or Provider name |
first_name | (For Individuals) Supports wildcards (jo*) |
use_first_name_alias | Set True to include similar names (e.g., Robert → Rob, Bob) |
last_name | (For Individuals) Supports wildcards (doe*) |
organization_name | (For Organizations) Supports wildcards |
address_purpose | Filter by Location, Mailing, Primary, Secondary |
city | City name |
state | 2-letter state code (must be used with another filter) |
postal_code | Supports wildcard (21*) |
country_code | Filter by country |
limit | Default: 10 (Max: 200) |
skip | Skip N results (max: 1000) |
pretty | Format response for readability |
API Response
Output format: JSON
Main response objects:
Addresses[]: Primary and Mailing addresses.Other Identifiers[]: Up to 50 records.Taxonomies[]: Up to 15 records.Other Names[]: Multiple occurrences.Endpoints[]: API endpoints.Practice Locations[]: All practice locations (except primary).
Interactive Testing
You can test queries using the Interactive Demo: Click Here
Data Mapping
Signing/Referral Doctor Fields
| WebApp Field | API Field | Example Value |
|---|---|---|
| Designation | basic.name_prefix | Mr. |
| Provider Name | basic.first_name, basic.middle_name, basic.last_name | Michael Dru Abrego |
| Display Name | basic.first_name, basic.last_name | Michael Abrego |
| Registration Number | NPI | 1396040903 |
| Speciality | taxonomies[].desc (Primary: primary: true) | Nurse Practitioner, Critical Care Medicine |
| Address | addresses[].address_1, addresses[].address_2, addresses[].city, addresses[].state, addresses[].postalcode | 6807 EMMETT F LOWRY EXPY SUITE 303 TEXAS CITY, TX 77591-2546 United States |
| City | addresses[].city | TEXAS CITY |
| State | addresses[].state | TX |
| Zipcode | addresses[].postalcode | 77591-2546 |
| Fax Number | addresses[].fax_number | 409-935-3433 |
| Contact Number | addresses[].telephone_number | 409-935-2995 |
Organization Fields
| WebApp Field | API Field | Example Value |
| Organization Name | basic.organization_name | 30 CHIROPRACTIC |
| Contact | addresses[].telephone_number | 704-821-5000 |
| Fax Number | addresses[].fax_number | 409-935-8685 |
| Alternate Contact Number | basic.authorized_official_telephone_number | 7048215000 |
| Address | addresses[].address_1, addresses[].city, addresses[].state, addresses[].postal_code, addresses[].country_name | 616 Indian Trail Rd S, Indian Trail, NC 28079-9680, United States |
| City | addresses[].city | Indian Trail |
| State | addresses[].state | NC |
| Zipcode | addresses[].postal_code | 28079-9680 |
| Country | addresses[].country_name | United States |
| NPI number | NPI | 1508971326 |
| NPI Type | NPI-2 Organization |