NPPES Read API Version 2 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
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
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 or MAILING (Other criteria required)
city
     Exact Name
state
     2 Characters (Other criteria required)
postal_code      At least 2 characters, wildcard is implied
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/resultsDemo2/?city=baltimore
https://npiregistry.cms.hhs.gov/api/resultsDemo2/?city=baltimore&postal_code=212&pretty=true