NPPES Read API 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?city=baltimore
https://npiregistry.cms.hhs.gov/api?city=baltimore&postal_code=212&pretty=true