String docs
Site integrations

NPPES NPI Registry

The CMS NPPES NPI Registry of every US healthcare practitioner and organization with an NPI: search by name, NPI, city, state, ZIP or specialty, with credential, practice and mailing addresses and phone numbers, specialties with state license numbers, other names, enumeration and update dates, and an organization's authorized official.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: nppes
  • Version: 1.0.0
  • Reads from: npiregistry.cms.hhs.gov
ActionDescriptionListed price
searchSearch the NPPES NPI Registry of US healthcare practitioners and organizations with an NPI by name, NPI, city, state, ZIP or specialty. Each row is one NPI: name, credential, sex, organization and its authorized official, status and dates, mailing and practice addresses with phone and fax, specialties with state license numbers, other names, identifiers and exchange endpoints. 200 a page.Billed per request at your plan's rates

Search the NPPES NPI Registry of US healthcare practitioners and organizations with an NPI by name, NPI, city, state, ZIP or specialty. Each row is one NPI: name, credential, sex, organization and its authorized official, status and dates, mailing and practice addresses with phone and fax, specialties with state license numbers, other names, identifiers and exchange endpoints. 200 a page.

POST https://request.usestring.ai/v1/integrations/nppes/search

Input

Unknown fields are rejected.

FieldTypeDescription
npistringAn NPI number (the registry's 10-digit identifier) Matches ^[0-9]{10}$.
firstNamestringA practitioner's first name; end with * to match a prefix of at least two letters. At most 100 characters.
lastNamestringA practitioner's last name; end with * to match a prefix. At most 100 characters.
organizationNamestringAn organization's name; end with * to match a prefix. At most 100 characters.
citystringAt most 100 characters.
statestringTwo-letter state of an address. Matches ^[A-Za-z]{2}$.
postalCodestringZIP code, 5 or 9 digits; end with * to match a prefix. Matches ^[0-9]{2,9}\*?$.
taxonomystringWords in a specialty's description, such as Surgery or Dentist. At most 100 characters.
enumerationTypeNPI-1 NPI-2NPI-1 for individual practitioners, NPI-2 for organizations.
pagesintegerHow many pages of 200 records to read, from 1. From 1 to 6.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
npistringnumber.
enumerationTypestringNPI-1 for an individual, NPI-2 for an organization.
urlstringThe record's page on the NPI Registry.
firstNamestring | null—
middleNamestring | null—
lastNamestring | null—
namePrefixstring | null—
nameSuffixstring | null—
credentialstring | nullSuch as MD, DDS or RN.
sexstring | null—
soleProprietorstring | nullYES or NO.
organizationNamestring | null—
organizationalSubpartstring | null—
authorizedOfficialobject | nullThe person who signed an organization's enumeration.
authorizedOfficial.firstNamestring | null—
authorizedOfficial.middleNamestring | null—
authorizedOfficial.lastNamestring | null—
authorizedOfficial.titlestring | nullTitle or position.
authorizedOfficial.telephonestring | null—
statusstring | nullA for active.
enumerationDatestring | nullWhen the NPI was issued, YYYY-MM-DD.
lastUpdatedstring | nullYYYY-MM-DD.
certificationDatestring | null—
addressesobject[]The mailing and primary practice (LOCATION) addresses.
addresses[].purposestring | nullMAILING or LOCATION.
addresses[].address1string | null—
addresses[].address2string | null—
addresses[].citystring | null—
addresses[].statestring | null—
addresses[].postalCodestring | null—
addresses[].countryCodestring | null—
addresses[].telephonestring | null—
addresses[].faxstring | null—
practiceLocationsobject[]Other practice locations.
practiceLocations[].purposestring | nullMAILING or LOCATION.
practiceLocations[].address1string | null—
practiceLocations[].address2string | null—
practiceLocations[].citystring | null—
practiceLocations[].statestring | null—
practiceLocations[].postalCodestring | null—
practiceLocations[].countryCodestring | null—
practiceLocations[].telephonestring | null—
practiceLocations[].faxstring | null—
taxonomiesobject[]Specialties, with the state license for each.
taxonomies[].codestringThe taxonomy code (the registry's specialty code)
taxonomies[].descriptionstring | null—
taxonomies[].licensestring | nullThe state license number.
taxonomies[].statestring | nullThe license's state.
taxonomies[].primaryboolean—
otherNamesobject[]Former, professional or doing-business-as names.
otherNames[].typestring | nullSuch as Former Name, Professional Name or Doing Business As.
otherNames[].firstNamestring | null—
otherNames[].middleNamestring | null—
otherNames[].lastNamestring | null—
otherNames[].credentialstring | null—
otherNames[].organizationNamestring | null—
identifiersobject[]Other identifiers, such as a state Medicaid number.
identifiers[].codestring | null—
identifiers[].descriptionstring | null—
identifiers[].identifierstring | null—
identifiers[].issuerstring | null—
identifiers[].statestring | null—
endpointsobject[]Health information exchange endpoints, such as Direct messaging addresses.
endpoints[].typestring | null—
endpoints[].descriptionstring | null—
endpoints[].endpointstring | null—
endpoints[].usestring | null—
endpoints[].affiliationstring | null—

Example

curl https://request.usestring.ai/v1/integrations/nppes/search \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Atul",
    "lastName": "Gawande"
  }'

data starts with these rows:

[
  {
    "npi": "1578671483",
    "enumerationType": "NPI-1",
    "url": "https://npiregistry.cms.hhs.gov/search",
    "firstName": "ATUL",
    "middleName": null,
    "lastName": "GAWANDE",
    "namePrefix": null,
    "nameSuffix": null,
    "credential": "MD",
    "sex": "M",
    "soleProprietor": "NO",
    "organizationName": null,
    "organizationalSubpart": null,
    "authorizedOfficial": null,
    "status": "A",
    "enumerationDate": "2006-08-29",
    "lastUpdated": "2012-05-30",
    "certificationDate": null,
    "addresses": [
      {
        "purpose": "MAILING",
        "address1": "111 CYPRESS ST",
        "address2": null,
        "city": "BROOKLINE",
        "state": "MA",
        "postalCode": "024456002",
        "countryCode": "US",
        "telephone": "857-307-0896",
        "fax": null
      },
      {
        "purpose": "LOCATION",
        "address1": "BRIGHAM AND WOMEN'S HOSPITAL DIVISION OF GENERAL AND GA",
        "address2": "75 FRANCIS STREET ASBII",
        "city": "BOSTON",
        "state": "MA",
        "postalCode": "02115",
        "countryCode": "US",
        "telephone": "617-732-6830",
        "fax": null
      }
    ],
    "practiceLocations": [],
    "taxonomies": [
      {
        "code": "208600000X",
        "description": "Surgery",
        "license": "154941",
        "state": "MA",
        "primary": true
      }
    ],
    "otherNames": [],
    "identifiers": [],
    "endpoints": []
  }
]

Requests and billing

  • Requests: 1–2 Web Access requests per result page.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.