Skip to main content
Public recordsUS$0.000 per row

NPI Registry (NPPES)

US healthcare providers from the CMS NPI Registry: NPI, organisation or provider name, specialty (taxonomy), practice address and phone, by NPI or by name, specialty and location.

What goes in, what comes back

Input

The request body: the fields of params, then run options that sit next to params.

NPI Registry (NPPES) input parameters
FieldTypeNotes
params.numberstringOne 10-digit NPI. Otherwise at least one search field is required.
params.organization_namestringOrganisation name (trailing * for prefix match).
params.first_namestringIndividual provider first name.
params.last_namestringIndividual provider last name.
params.taxonomy_descriptionstringSpecialty, e.g. "dentist".
params.citystringPractice city.
params.statestringTwo-letter state (combine with another field).
params.postal_codestringZIP code (5 or 9 digits).
params.enumeration_typestringNPI-1 (individuals) or NPI-2 (organisations).
maxResultsnumberMost providers to return (1 to 1000, default 100). Sent next to params, not inside it.

Result

Every row in rows has these fields.

NPI Registry (NPPES) result fields
FieldTypeNotes
npistring10-digit National Provider Identifier
enumeration_typestringNPI-1 individual, NPI-2 organisation
organization_namestring
provider_first_namestringIndividual providers only. Personal data
provider_last_namestringIndividual providers only. Personal data
credentialstringe.g. MD, DDS (individuals)
primary_taxonomy_codestring
primary_taxonomystringSpecialty
address_1stringPractice location
address_2string
citystring
statestring
postal_codestring
country_codestring
phonestringPractice location phone
statusstringA = active
enumeration_datestring
last_updatedstring
registry_urlstring

Sample request

  • Dentists in Austin, TX: {"params":{"taxonomy_description":"dentist","city":"Austin","state":"TX"},"maxResults":100}
  • One NPI: {"params":{"number":"1881018208"}}

Every snippet reads your key from SUPERSCRAPER_API_KEY.

The run endpoint opens with the data catalog

The schema and request on this page are what the run call takes and returns. Until the catalog opens, the call answers 404.
curl -X POST https://api.superscraper.dev/v1/connectors/npi-nppes/run \
  -H "Authorization: Bearer $SUPERSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params":{"taxonomy_description":"dentist","city":"Austin","state":"TX"},"maxResults":100}'

Get a key

Free to start. Each returned row is billed at the price above.