nppesDetail

Query to specify data request for individual and organizational provider detail, specialty, location and organizational status as reported to CMS's National Plan and Provider Enumeration System (NPPES) on a monthly basis.

Get Started with nppesDetail

If you have already setup CareQuery, run the below code to get started with your first nppesDetail query.

Example:

🔍

Request NPPES data for all cardio specialists in Colorado and New Mexico.

# import package
from care_query.care_query import CareQuery

# instantiate and connect
cq = CareQuery(email = "your-email", 
               token = "your-api-token")

# construct query
query = cq.nppesDetail(specialty = "internal medicine - cardiovascular disease",
                       state = ["CO","NM"])

# estimate query size (optional)
estimate = query.estimate() 

# return query sample data (optional)
sample = query.sample() 

# execute query to return results
data = query.execute() 

Query Parameters

The following a parameters are available within the nppesDetail query, including details on the parameter values.

parameter

description

options

npi

National Provider Identifier (NPI) of individual and/or
organizational provider(s) that appear on the encounter.

Any Valid NPI

taxonomy_code

Taxonomy of the organization or individual provider, 10-digit code that used to identify the type, classification, and area of specialization of an individual or organizational healthcare provider

values available

specialty

Specialty of the organization or individual provider(s), specific focus of a provider by patient population, disease, skill or philosophy

values available

specialty_category

Specialty category of the organization or individual provider(s), broad focus of a provider by patient population, disease, skill or philosophy

values available

subspecialty

Specialty subcategory of the organization or individual
provider(s), hyper-specific focus of a provider by patient
population, disease, skill or philosophy

values available

state

US State residence of the query patient population

values available

division

Nine distinct US State groupings as defined by the US Census Bureau

values available

region

Four major US State groupings as defined by the US Census Bureau

values available

zip

Primary zip code of the individual or organizational provider

Valid US
zip code(s)

limit

Number of rows returned in the data request

Integer or False

show

Binary indicator as to whether you'd like
query to be printed for review upon it's creation

True or False

Query Return Data

The nppesDetail query returns the NPPES_TABLE for all National Provider Identifiers (NPIs) that meet the criterion specified within the query.

The NPPES_TABLE offers NPPES's detail, credentials, taxonomies and contact information of registered providers.

featuredescriptionexample
npiNational Provider Identifier (NPI) of the individual/organizational provider registered with NPPES.1306587324
nameFull name or organizational name of the individual/organizational provider registered with NPPES.cristina papari
entity_typeIndicator of whether the corresponding provider is an individual or organization.individual
genderGender of the individual provider.f
credentialMedical credential of the individual provider.md
primary_taxonomy_codePrimary taxonomy code of the individual/organizational provider.207Q00000X
secondary_taxonomy_codeSecondary taxonomy code of the individual/organizational provider.235Z00000X
addressPrimary address of the individual/organizational provider, as reported to NPPES.200 hawkins dr
cityCity, State of the primary address of the individual/organizational provider, as reported to NPPES.iowa city
stateState of the primary address of the individual/organizational provider, as reported to NPPES.IA
zipZip code of the primary address of the individual/organizational provider, as reported to NPPES.52242
phonePrimary phone number of the individual/organizational provider, as reported to NPPES.3193847507
faxPrimary fax number of the individual/organizational provider, as reported to NPPES.3193847822
sole_proprietorBinary indicator (yes, no) as to whether the provider is registered as a sole proprietor with NPPES.No
org_subpartBinary indicator (yes, no) as to whether the provider is registered as an organizational subpart with NPPES.No
org_lbnLegal business name of the parent organization associated with an NPI.consumerhealth, inc.
update_dateThe last date in which NPPES dataset has been updated2023-09-01

Advanced Query Logic & Recipes

nppesDetail gives users categorical groupings for ease of use, as well as SQL-like capabilities to tactfully specify AND and OR logic, right within the CareQuery API!

🚧

nppesDetail does not allow for nested lists within the query parameters

Please reference the following resources to better understand how to create rockstar queries!