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
| Action | Description | Listed price |
|---|---|---|
search | 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. | Billed per request at your plan's rates |
search
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/searchInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
npi | string | An NPI number (the registry's 10-digit identifier) Matches ^[0-9]{10}$. |
firstName | string | A practitioner's first name; end with * to match a prefix of at least two letters. At most 100 characters. |
lastName | string | A practitioner's last name; end with * to match a prefix. At most 100 characters. |
organizationName | string | An organization's name; end with * to match a prefix. At most 100 characters. |
city | string | At most 100 characters. |
state | string | Two-letter state of an address. Matches ^[A-Za-z]{2}$. |
postalCode | string | ZIP code, 5 or 9 digits; end with * to match a prefix. Matches ^[0-9]{2,9}\*?$. |
taxonomy | string | Words in a specialty's description, such as Surgery or Dentist. At most 100 characters. |
enumerationType | NPI-1 NPI-2 | NPI-1 for individual practitioners, NPI-2 for organizations. |
pages | integer | How 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:
| Field | Type | Description |
|---|---|---|
npi | string | number. |
enumerationType | string | NPI-1 for an individual, NPI-2 for an organization. |
url | string | The record's page on the NPI Registry. |
firstName | string | null | — |
middleName | string | null | — |
lastName | string | null | — |
namePrefix | string | null | — |
nameSuffix | string | null | — |
credential | string | null | Such as MD, DDS or RN. |
sex | string | null | — |
soleProprietor | string | null | YES or NO. |
organizationName | string | null | — |
organizationalSubpart | string | null | — |
authorizedOfficial | object | null | The person who signed an organization's enumeration. |
authorizedOfficial.firstName | string | null | — |
authorizedOfficial.middleName | string | null | — |
authorizedOfficial.lastName | string | null | — |
authorizedOfficial.title | string | null | Title or position. |
authorizedOfficial.telephone | string | null | — |
status | string | null | A for active. |
enumerationDate | string | null | When the NPI was issued, YYYY-MM-DD. |
lastUpdated | string | null | YYYY-MM-DD. |
certificationDate | string | null | — |
addresses | object[] | The mailing and primary practice (LOCATION) addresses. |
addresses[].purpose | string | null | MAILING or LOCATION. |
addresses[].address1 | string | null | — |
addresses[].address2 | string | null | — |
addresses[].city | string | null | — |
addresses[].state | string | null | — |
addresses[].postalCode | string | null | — |
addresses[].countryCode | string | null | — |
addresses[].telephone | string | null | — |
addresses[].fax | string | null | — |
practiceLocations | object[] | Other practice locations. |
practiceLocations[].purpose | string | null | MAILING or LOCATION. |
practiceLocations[].address1 | string | null | — |
practiceLocations[].address2 | string | null | — |
practiceLocations[].city | string | null | — |
practiceLocations[].state | string | null | — |
practiceLocations[].postalCode | string | null | — |
practiceLocations[].countryCode | string | null | — |
practiceLocations[].telephone | string | null | — |
practiceLocations[].fax | string | null | — |
taxonomies | object[] | Specialties, with the state license for each. |
taxonomies[].code | string | The taxonomy code (the registry's specialty code) |
taxonomies[].description | string | null | — |
taxonomies[].license | string | null | The state license number. |
taxonomies[].state | string | null | The license's state. |
taxonomies[].primary | boolean | — |
otherNames | object[] | Former, professional or doing-business-as names. |
otherNames[].type | string | null | Such as Former Name, Professional Name or Doing Business As. |
otherNames[].firstName | string | null | — |
otherNames[].middleName | string | null | — |
otherNames[].lastName | string | null | — |
otherNames[].credential | string | null | — |
otherNames[].organizationName | string | null | — |
identifiers | object[] | Other identifiers, such as a state Medicaid number. |
identifiers[].code | string | null | — |
identifiers[].description | string | null | — |
identifiers[].identifier | string | null | — |
identifiers[].issuer | string | null | — |
identifiers[].state | string | null | — |
endpoints | object[] | Health information exchange endpoints, such as Direct messaging addresses. |
endpoints[].type | string | null | — |
endpoints[].description | string | null | — |
endpoints[].endpoint | string | null | — |
endpoints[].use | string | null | — |
endpoints[].affiliation | string | 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.
Companies House
The UK Companies House register's officers: search officers (directors, secretaries, LLP members, persons with significant control are not included) by name, with appointment count, birth month and year and address; and every appointment an officer holds or held, with company name, number and status, role, appointed and resigned dates, nationality, country of residence and correspondence address.
Babylist
Babylist baby registries: a registry's summary (owner names, location, arrival date, item count) and its full item list with prices, retailers and purchase status, exactly as the public /list/<slug> page shows them.