Skip Navigation Link. Please press insert + down arrow if jaws does not start reading the content.

NPPES Read API Version 2.1 Help


Use the following form to experiment with generating valid queries. After pressing Submit, the query can be found as the result.

FieldValueDescription
versionVersion of API. Use 2.1
numberExactly 10 digits
enumeration_typeNPI-1 or NPI-2 (Other criteria required)
taxonomy_descriptionExact Description or Exact Specialty or wildcard * after 2 characters
name_purposeAO or PROVIDER (Other criteria required)
first_nameExact name, or wildcard * after 2 charactersUse for type 1
use_first_name_aliasTrue or False (Other criteria required)Use for type 1 (PROVIDER) or type 2 (AO) First Name searches
last_nameExact name, or wildcard * after 2 charactersUse for type 1
organization_nameExact name, or wildcard * after 2 charactersUse for type 2
address_purposeLOCATION, MAILING, PRIMARY or SECONDARY. (Other criteria required)
cityExact city, or wildcard * after 2 characters
state2 Characters (Other criteria required)
postal_codeExact Postal Code (5 digits will also return 9 digit zip + 4), or wildcard * after 2 characters
country_codeExactly 2 characters (if "US", other criteria required)
limitLimit results, default = 10, max = 200
skipSkip first N results, max = 1000
pretty
Response will be formatted with indented lines

Examples:
https://npiregistry.cms.hhs.gov/api/?version=2.1&city=baltimore
https://npiregistry.cms.hhs.gov/api/?version=2.1&city=baltimore&postal_code=212&pretty=on

Result: