NPPES Enrichment

NPPES enrichment adds detailed practice, credential, specialty, name, and other information to healthcare provider and organization entities.

The National Plan & Provider Enumeration System (NPPES) is a comprehensive, uniform system for identifying and uniquely enumerating health care providers and plans at the national level. The NPPES enrichment service matches healthcare providers and healthcare organizations using National Plan Identifier (NPI) numbers and returns additional attributes, including the business and practice information, endpoints, and NPI lifecycle.

This service is included without additional licensing in the Healthcare Providers data product for provider data, and in the B2B Customers data product for healthcare organization data.

For health care organization mastering, we recommend mapping NPI numbers to "Registration Number" in the B2B Customers data product schema. Values mapped to "Registration Number" will be matched against the NPPES database. Match statuses for B2B Customers enrichment is available here.

NPPES Enrichment Attributes

The following attributes are provided by the enricher for each matching provider. When there is a tie in priority order, the ranking of records, or match status, is determined based on attribute similarity between the source and reference record in the NPPES corpus.

Output Attribute NameDescriptionAvailable for Provider or Organization
tamr_nppes_enrich_statusThe status of NPPES enrichment:
  • MATCH_NPI: a match was found, based on exact match of the NPI number
  • MATCH_NAME_STREET_ADDRESS: a match was found based on the provider name and full address
  • MATCH_LICENSE_NUMBER: a match was found based on the license number
  • MATCH_NAME_CITY: a match was found based on the provider name and city
  • MATCH_NAME_REGION: a match was found based on the provider name and region or state
  • MATCH_PHONE: a match was found based on the provider phone number
  • MATCH_EMAIL: a match was found based on the email address
  • DEACTIVATED_NPI: a match was found for the NPI number, but the NPI is marked as deactivated
  • NO_MATCH_MISSING_NPI: no match is possible because the input NPI is empty
  • NO_MATCH: no match was found for the NPI number
Provider only
nppes_tamr_enrich_statusThe status of the NPPES enrichment:
  • MATCH_NAME_ADDRESS: The enrichment attributes provided by NPPES were matched to this organization based on the organization name and full address.
  • MATCH_NAME_CITY: The enrichment attributes provided by NPPES were matched to this organization based on the organization name, city, country, and either region or postal code.
  • MATCH_HIERARCHY_COUNTRY: The enrichment attributes provided by NPPES were matched this company based on the combination of the organization name, domestic ultimate parent, and country. This match is typically less precise than one based on name and full address.
  • MATCH_REGISTRATION_NUMBER: The enrichment attributes provided by NPPES were matched to this organization based on the organization's registration number (typically the NPI number).
  • MATCH_NAME_COUNTRY: The enrichment attributes provided by NPPES were matched to this organization based on the organization and country.
  • MATCH_PHONE: The enrichment attributes provided by NPPES were matched to this organization based on the cleaned phone number.
  • MATCH_WEBSITE: The enrichment attributes provided by NPPES were matched to this organization based on the cleaned website.
  • NOT_AVAILABLE_IN_SELECTED_SOURCE: NPPES does not have information associated with this organization’s Tamr Enrich ID.
  • UNRECOGNIZED_TAMR_ENRICH ID: Tamr Enrich does not recognize the ID.
  • NO_MATCH_INVALID_NAME: A match was not found due to an invalid organization name. Either the name was empty, or the name contained only special characters or generic legal form information (for example CORP or LLC).
  • NO_MATCH_INVALID_COUNTRY: A match was not found due to an invalid (empty) country.
  • NO_MATCH: A match was not found.

    Note: This value may not match the Tamr Enrich ID tamr_firmographic_match_status. This happens when a higher level match is available in one of the other supported data providers. For example, a match based on “MATCH_NAME_ADDRESS” was found in Companies House, and a match based on “MATCH_NAME_COUNTRY” was found in NPPES (the selected provider). In this case, the value of the Tamr Enrich ID tamr_firmographic_match_status is "MATCH_NAME_ADDRESS" while the value of nppes_tamr_enrich_status is "MATCH_NAME_COUNTRY".
Organization only
nppes_npiThe National Provider Identifier, which is a unique 10-digit identification number issued to health care providers in the United States by the Centers for Medicare and Medicaid Services (CMS).Both
nppes_entity_type_codeThe type of provider (type 1 is an individual and type 2 is an organization).Both
nppes_replacement_npiThe replacement NPI, if the provider has been issued one.Both
nppes_employer_identification_number_einThe Employer Identification Number, which is a nine-digit number assigned by the IRS.Provider only
nppes_provider_organization_name_legal_business_nameThe legal business name of the provider’s organization.Both
nppes_provider_last_name_legal_nameThe provider's legal last name.Provider only
nppes_provider_first_nameThe provider's first name.Provider only
nppes_provider_middle_nameThe provider's middle name.Provider only
nppes_provider_name_prefix_textThe provider's name prefix, such as Dr., Ms., or Mr.Provider only
nppes_provider_name_suffix_textThe provider's name suffix, such as Jr. or Sr.Provider only
nppes_provider_credential_textThe provider's credential text, such as MD.Provider only
nppes_provider_other_organization_nameThe first other name used by this provider's organization, such as a former legal business name or another name under which the organization has done business.Both
nppes_provider_other_organization_name_type_codeThe code that represents the type of other organization name for the first other name, such as a former legal business name.Both
nppes_provider_other_last_nameOther last name used by this provider.Provider only
nppes_provider_other_first_nameOther first name used by this provider.Provider only
nppes_provider_other_middle_nameOther middle name used by this provider.Provider only
nppes_provider_other_name_prefix_textOther name prefix used by this provider, such as Dr., Ms., or Mr.Provider only
nppes_provider_other_name_suffix_textOther name suffix used by this provider, such as Jr. or Sr.Provider only
nppes_provider_other_credential_textOther credentials for this provider.Provider only
nppes_provider_other_last_name_type_codeThe code that represents the type of other last name, such as a former or professional name.Provider only
nppes_provider_first_line_business_mailing_addressThe first line of the provider’s business mailing address.Both
nppes_provider_second_line_business_mailing_addressThe second line of the provider's business mailing address.Both
nppes_provider_business_mailing_address_city_nameThe city name of the provider's business mailing address.Both
nppes_provider_business_mailing_address_state_nameThe state name of the provider's business mailing address.Both
nppes_provider_business_mailing_address_postal_codeThe postal code of the provider's business mailing address.Both
nppes_provider_business_mailing_address_country_code_if_outside_u_sThe country code of the provider's business mailing address, for addresses outside of the United States.Both
nppes_provider_business_mailing_address_telephone_numberThe telephone number associated with the provider's business mailing address.Both
nppes_provider_business_mailing_address_fax_numberThe fax number associated with the provider's business mailing address.Both
nppes_provider_first_line_business_practice_location_addressThe first line of the provider’s business practice location address.Both
nppes_provider_second_line_business_practice_location_addressThe second line of the provider's business practice location address.Both
nppes_provider_business_practice_location_address_city_nameThe city name of the provider's business practice location address.Both
nppes_provider_business_practice_location_address_state_nameThe state name of the provider's business practice location address.Both
nppes_provider_business_practice_location_address_postal_codeThe postal code of the provider's business practice location address.Both
nppes_provider_business_practice_location_address_country_code_if_outside_u_sThe country code of the provider's business practice location address, if the address is outside of the United States.Both
nppes_provider_business_practice_location_address_telephone_numberThe telephone number associated with the provider's business practice location address.Both
nppes_provider_business_practice_location_address_fax_numberThe fax number of the provider's business practice location address.Both
nppes_provider_enumeration_dateThe date on which the NPI was assigned.Both
nppes_last_update_dateThe date on which the NPI was last updated.Both
nppes_npi_deactivation_reason_codeThe reason code associated with NPI deactivation, such as DT for Death or DB for disbandment.Both
nppes_npi_deactivation_dateThe date on which the NPI was deactivated.Both
nppes_npi_reactivation_dateThe date on which the NPI was reactivated.Both
nppes_provider_gender_codeThe provider's gender.Provider only
nppes_provider_licensenumber<1-15>The provider's medical license number, for up to 15 licenses.Both
nppes_provider_license_number_statecode<1-15>The state code of the state in which the provider is licensed, such as CA or MA, for up to 15 licenses.Both
nppes_certification_dateThe date on which the NPI was certified.Both
nppes_authorized_official_last_nameThe last name of the authorized official for this provider.Organization only
nppes_authorized_official_first_nameThe first name of the authorized official for this provider.Organization only
nppes_authorized_official_middle_nameThe midle name of the authorized official for this provider.Organization only
nppes_authorized_official_title_or_positionThe title of the authorized official for this provider.Organization only
nppes_authorized_official_telephone_numberThe telephone number for the authorized official for this provider.Organization only
nppes_num_secondary_practice_addressesThe number of secondary practice addresses for the provider.Both
nppes_secondary_practice_address_line_1_1The first line of secondary practice address 1.Both
nppes_secondary_practice_address_line_2_1The second line of secondary practice address 1.Both
nppes_secondary_practice_city_name_1The city name of secondary practice address 1.Both
nppes_secondary_practice_state_name_1The state name of secondary practice address 1.Both
nppes_secondary_practice_postal_code_1The postal code of secondary practice address 1.Both
nppes_secondary_practice_country_code_1The country code of secondary practice address 1, for addresses outside of the United States.Both
nppes_secondary_practice_telephone_number_1The phone number associated with secondary practice address 1.Both
nppes_secondary_practice_telephone_extension_1The phone number extension associated with secondary practice address 1.Both
nppes_secondary_practice_fax_number_1The fax number associated with secondary practice address 1.Both
nppes_secondary_practice_address_line_1_2The first line of secondary practice address 2.Both
nppes_secondary_practice_address_line_2_2The second line of secondary practice address 2.Both
nppes_secondary_practice_city_name_2The city name of secondary practice address 2.Both
nppes_secondary_practice_state_name_2The state name of secondary practice address 2.Both
nppes_secondary_practice_postal_code_2The postal code of secondary practice address 2.Both
nppes_secondary_practice_country_code_2The country code of secondary practice address 2, for addresses outside of the United States.Both
nppes_secondary_practice_telephone_number_2The phone number associated with secondary practice address 2.Both
nppes_secondary_practice_telephone_extension_2The phone number extension associated with secondary practice address 2.Both
nppes_secondary_practice_fax_number_2The fax number associated with secondary practice address 2.Both
nppes_secondary_practice_address_line_1_3The first line of secondary practice address 3.Both
nppes_secondary_practice_address_line_2_3The second line of secondary practice address 3.Both
nppes_secondary_practice_city_name_3The city name of secondary practice address 3.Both
nppes_secondary_practice_state_name_3The state name of secondary practice address 3.Both
nppes_secondary_practice_postal_code_3The postal code of secondary practice address 3.Both
nppes_secondary_practice_country_code_3The country code of secondary practice address 3, for addresses outside of the United States.Both
nppes_secondary_practice_telephone_number_3The phone number associated with secondary practice address 3.Both
nppes_secondary_practice_telephone_extension_3The phone number extension associated with secondary practice address 3.Both
nppes_secondary_practice_fax_number_3The fax number associated with secondary practice address 3.Both
nppes_secondary_practice_address_line_1_4The first line of secondary practice address 4.Both
nppes_secondary_practice_address_line_2_4The second line of secondary practice address 4.Both
nppes_secondary_practice_city_name_4The city name of secondary practice address 4.Both
nppes_secondary_practice_state_name_4The state name of secondary practice address 4.Both
nppes_secondary_practice_postal_code_4The postal code of secondary practice address 4.Both
nppes_secondary_practice_country_code_4The country code of secondary practice address 4, for addresses outside of the United States.Both
nppes_secondary_practice_telephone_number_4The phone number associated with secondary practice address 4.Both
nppes_secondary_practice_telephone_extension_4The phone number extension associated with secondary practice address 4.Both
nppes_secondary_practice_fax_number_4The fax number associated with secondary practice address 4.Both
nppes_secondary_practice_address_line_1_5The first line of secondary practice address 5.Both
nppes_secondary_practice_address_line_2_5The second line of secondary practice address 5.Both
nppes_secondary_practice_city_name_5The city name of secondary practice address 5.Both
nppes_secondary_practice_state_name_5The state name of secondary practice address 5.Both
nppes_secondary_practice_postal_code_5The postal code of secondary practice address 5.Both
nppes_secondary_practice_country_code_5The country code of secondary practice address 5, for addresses outside of the United States.Both
nppes_secondary_practice_telephone_number_5The phone number associated with secondary practice address 5.Both
nppes_secondary_practice_telephone_extension_5The phone number extension associated with secondary practice address 5.Both
nppes_secondary_practice_fax_number_5The fax number associated with secondary practice address 5.Both
nppes_num_othernamesThe number of other names used by this provider's organization.Both
nppes_othernames_provider_other_organization_name_1Other name 1 used by this provider's organization.Both
nppes_othernames_provider_other_organization_name_2Other name 2 used by this provider's organization.Both
nppes_othernames_provider_other_organization_name_3Other name 3 used by this provider's organization.Both
nppes_othernames_provider_other_organization_name_4Other name 4 used by this provider's organization.Both
nppes_othernames_provider_other_organization_name_5Other name 5 used by this provider's organization.Both
nppes_othernames_provider_other_organization_name_type_code_1The code that represents the type of other organization name 1, such as a former legal business name.Both
nppes_othernames_provider_other_organization_name_type_code_2The code that represents the type of other organization name 2, such as a former legal business name.Both
nppes_othernames_provider_other_organization_name_type_code_3The code that represents the type of other organization name 3, such as a former legal business name.Both
nppes_othernames_provider_other_organization_name_type_code_4The code that represents the type of the other organization name 4, such as a former legal business name.Both
nppes_othernames_provider_other_organization_name_type_code_5The code that represents the type of the other organization name 5, such as a former legal business name.Both
nppes_num_endpointsThe number of endpoints for this provider. Endpoints provide a simple, secure, scalable, and standards-based way to send authenticated, encrypted health information directly to known, trusted recipients over the Internet.Both
nppes_endpoint_type_1The type of endpoint for endpoint 1, such as address for direct messaging, RESTful URL, SOAP URL, and so on.Both
nppes_endpoint_type_description_1The description of endpoint 1.Both
nppes_endpoint_1Endpoint 1 for sending authenticated, encrypted healthcare informaion over the Internet.Both
nppes_endpoint_type_2The type of endpoint for endpoint 2, such as address for direct messaging, RESTful URL, SOAP URL, and so on.Both
nppes_endpoint_type_description_2The description of endpoint 2.Both
nppes_endpoint_2Endpoint 2 for sending authenticated, encrypted healthcare informaion over the Internet.Both
nppes_endpoint_type_3The type of endpoint for endpoint 3, such as address for direct messaging, RESTful URL, SOAP URL, and so on.Both
nppes_endpoint_type_description_3The description of endpoint 3.Both
nppes_endpoint_3Endpoint 3 for sending authenticated, encrypted healthcare informaion over the Internet.Both
nppes_endpoint_type_4The type of endpoint for endpoint 4, such as address for direct messaging, RESTful URL, SOAP URL, and so on.Both
nppes_endpoint_type_description_4The description of endpoint 4.Both
nppes_endpoint_4Endpoint 4 for sending authenticated, encrypted healthcare informaion over the Internet.Both
nppes_endpoint_type_5The type of endpoint for endpoint 5, such as address for direct messaging, RESTful URL, SOAP URL, and so on.Both
nppes_endpoint_type_description_5A description of endpoint 5.Both
nppes_endpoint_5Endpoint 4 for sending authenticated, encrypted healthcare informaion over the Internet.Both
nppes_primary_healthcare_provider_taxonomy_codeThe primary taxonomy code for the provider, which is a unique 10-character code that designates a provider's classification and specialization.Both
nppes_primary_healthcare_provider_taxonomy_descriptionThe description of the provider's primary specialty, based on their primary taxonomy code.Both
nppes_other_specialties_descriptions(Deprecated; not included in data product output) The description of the provider's additional specialty, based on their non-primary taxonomy code.Both
nppes_other_specialties_code(Deprecated; not included in data product output) An additional taxonomy code for the provider, which is a unique 10-character code that designates a provider's classification and specialization.Both
nppes_other_specialties_code_1Other speciality code 1 for the provider, which is a unique 10-character code that designates a provider's classification and specialization.Both
nppes_other_specialties_code_2Other speciality code 2 for the provider, which is a unique 10-character code that designates a provider's classification and specialization.Both
nppes_other_specialties_code_3Other speciality code 3 for the provider, which is a unique 10-character code that designates a provider's classification and specialization.Both
nppes_other_specialties_code_4Other speciality code 4 for the provider, which is a unique 10-character code that designates a provider's classification and specialization.Both
nppes_other_specialties_code_5Other speciality code 5 for the provider, which is a unique 10-character code that designates a provider's classification and specialization.Both
nppes_other_specialties_descriptions_1The description of the provider's other specialty 1, based on their non-primary taxonomy code.Both
nppes_other_specialties_descriptions_2The description of the provider's other specialty 2, based on their non-primary taxonomy code.Both
nppes_other_specialties_descriptions_3The description of the provider's other specialty 3, based on their non-primary taxonomy code.Both
nppes_other_specialties_descriptions_4The description of the provider's other specialty 4, based on their non-primary taxonomy code.Both
nppes_other_specialties_descriptions_5The description of the provider's other specialty 5, based on their non-primary taxonomy code.Both


Did this page help you?

© 2025, Tamr, Inc. All rights reserved.

License Agreement | Privacy Policy | Data Security Policy| AI Chatbot Disclaimer