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 in the browser's address bar.

FieldValueDescription
version
      Version of API. Use 2.1
number
      Exactly 10 digits
enumeration_type
      NPI-1 or NPI-2 (Other criteria required)
taxonomy_description
      Exact Description or Exact Specialty or wildcard * after 2 characters
first_name
      Exact name, or wildcard * after 2 characters Use for type 1
use_first_name_alias
      True or False (Other criteria required) Use for type 1 First Name Search
last_name
      Exact name, or wildcard * after 2 charactersUse for type 1
organization_name
     Exact name, or wildcard * after 2 charactersUse for type 2
address_purpose
      LOCATION, MAILING, PRIMARY or SECONDARY. (Other criteria required)
city
     Exact city, or wildcard * after 2 characters
state
     2 Characters (Other criteria required)
postal_code      Exact Postal Code (5 digits will also return 9 digit zip + 4), or wildcard * after 2 characters
country_code
      Exactly 2 characters (if "US", other criteria required)
limit      Limit results, default = 10, max = 200
skip      Skip 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=true