Skip Navigation Link. Please press insert + down arrow if jaws does not start reading the content.

NPPES API Help



Conversion field map of the NPPES Data Dissemination CSV file to a JSON document

ColumnHeaderJSON fieldNote
1NPInumber 
2Entity Type Codeenumeration_type 
3Replacement NPIbasic.replacement_npi 
4Employer Identification Number (EIN)basic.ein 
5Provider Organization Name (Legal Business Name)basic.organization_name 
6Provider Last Name (Legal Name)basic.last_name 
7Provider First Namebasic.first_name 
8Provider Middle Namebasic.middle_name 
9Provider Name Prefix Textbasic.name_prefix 
10Provider Name Suffix Textbasic.name_suffix 
11Provider Credential Textbasic.credential 
12 to 20Provider Other Organization Name Not Used
21Provider First Line Business Mailing Addressaddresses[1].address_1 
22Provider Second Line Business Mailing Addressaddresses[1].address_2 
23Provider Business Mailing Address City Nameaddresses[1].city 
24Provider Business Mailing Address State Nameaddresses[1].state 
25Provider Business Mailing Address Postal Codeaddresses[1]. postal_code 
26Provider Business Mailing Address Country Code (If outside U.S.)addresses[1].country_code 
27Provider Business Mailing Address Telephone Numberaddresses[1].telephone_number 
28Provider Business Mailing Address Fax Numberaddresses[1]. fax_number 
 CONSTANT VALUEaddresses[1].address_purpose"MAILING"
29Provider First Line Business Practice Location Addressaddresses[0].address_1 
30Provider Second Line Business Practice Location Addressaddresses[0].address_2 
31Provider Business Practice Location Address City Nameaddresses[0].city 
32Provider Business Practice Location Address State Nameaddresses[0].state 
33Provider Business Practice Location Address Postal Codeaddresses[0]. postal_code 
34Provider Business Practice Location Address Country Code (If outside U.S.)addresses[0].country_code 
35Provider Business Practice Location Address Telephone Numberaddresses[0].telephone_number 
36Provider Business Practice Location Address Fax Numberaddresses[0]. fax_number 
 CONSTANT VALUEaddresses[0].address_purpose"LOCATION"
37Provider Enumeration Datebasic.enumeration_date 
 DERIVED VALUEcreated_epochDerived from Col 37
38Last Update Datebasic.last_updated 
 DERIVED VALUElast_updated_epochDerived from Col 38
39NPI Deactivation Reason Codebasic.deactivation_reason_code 
40NPI Deactivation Datebasic.deactivation_date 
41NPI Reactivation Datebasic.reactivation_date 
42Provider Sex Codebasic.sex 
43Authorized Official Last Namebasic.authorized_official_last_name 
44Authorized Official First Namebasic.authorized_official_first_name 
45Authorized Official Middle Namebasic.authorized_official_middle_name 
46Authorized Official Title or Positionbasic.authorized_official_title_or_position 
47Authorized Official Telephone Numberbasic.authorized_official_telephone_number 
48Healthcare Provider Taxonomy Code_1taxonomies[0].code 
49Provider License Number_1taxonomies[0].license 
50Provider License Number State Code_1taxonomies[0].state 
51Healthcare Provider Primary Taxonomy Switch_1taxonomies[0].primary 
 DERIVED VALUEtaxonomies[0].descDerived from code
********* 
104Healthcare Provider Taxonomy Code_15taxonomies[14].code 
105Provider License Number_15taxonomies[14].license 
106 Provider License Number State Code_15taxonomies[14].state 
107Healthcare Provider Primary Taxonomy Switch_15 taxonomies[14].primary 
 DERIVED VALUEtaxonomies[14].descDerived from code
108Other Provider Identifier_1identifiers[0].identifier 
109Other Provider Identifier Type Code_1identifiers[0].code 
110Other Provider Identifier State_1identifiers[0].state 
111Other Provider Identifier Issuer_1identifiers[0].issuer 
 DERIVED VALUEidentifiers[0].descDerived from code
********* 
304Other Provider Identifier_50identifiers[49].identifier 
305Other Provider Identifier Type Code_50identifiers[49].code 
306Other Provider Identifier State_50identifiers[49].state 
307Other Provider Identifier Issuer_50identifiers[49].issuer 
 DERIVED VALUEidentifiers[49].descDerived from code
308Is Sole Proprietorbasic.sole_proprietor 
309Is Organization Subpartbasic.organizational_subpart 
310Parent Organization LBNbasic.parent_organization_legal_business_name 
311Parent Organization TIN basic.parent_organization_ein 
312Authorized Official Name Prefix Textbasic.authorized_official_name_prefix 
313Authorized Official Name Suffix Textbasic.authorized_official_name_suffix 
314Authorized Official Credential Textbasic.authorized_official_credential 
315Healthcare Provider Taxonomy Group_1taxonomies[0].taxonomy_group 
********* 
329Healthcare Provider Taxonomy Group_15taxonomies[14].taxonomy_group 
330Certification Datebasic.certification_date 

Endpoints File

ColumnHeaderJSON fieldNote
1NPInumber 
2Endpoint Typeendpoints[n].endpointType 
3Endpoint Type Descriptionendpoints[n].endpointTypeDescription 
4Endpointendpoints[n].endpoint 
5Affiliationendpoints[n].affiliation 
6Endpoint Descriptionendpoints[n].endpointDescription 
7Affiliation Legal Business Nameendpoints[n].affliationName 
8Use Codeendpoints[n].use 
9Use Descriptionendpoints[n].useDescription 
10Other Use Descriptionendpoints[n].useOtherDescription 
11Content Codeendpoints[n].contentType 
12 Content Descriptionendpoints[n].contentTypeDescription 
13Other Content Descriptionendpoints[n].contentOtherDescription  
14Affiliation Address Line Oneendpoints[n].address_1 
15Affiliation Address Line Twoendpoints[n].address_2  
16Affiliation Address Cityendpoints[n].city 
17Affiliation Address Stateendpoints[n].state 
18Affiliation Address Countryendpoints[n].country_code 
19Affiliation Address Postal Codeendpoints[n].postal_code 
 DERIVED VALUEendpoints[n].country_nameDerived from Country Code
 DERIVED VALUEendpoints[n].address_typeDOM - Domestic
FGN - Foreign
MIL - Military

Other Names File

ColumnHeaderJSON fieldNote
1NPInumber 
2Provider Other Organization Nameother_names[n].organization_name 
3Provider Other Organization Name Type Codeother_names[n].code 
 DERVIVED VALUEother_names[n].typeType Description Derived From Name Type Code

Practice Locations

ColumnHeaderJSON fieldNote
1NPInumber 
2Provider Secondary Practice Location Address- Address Line 1practiceLocations[n].address_1 
3Provider Secondary Practice Location Address- Address Line 2practiceLocations[n].address_2 
4Provider Secondary Practice Location Address- City NamepracticeLocations[n].city 
5Provider Secondary Practice Location Address- State NamepracticeLocations[n].state 
6Provider Secondary Practice Location Address- Postal CodepracticeLocations[n].postal_code 
7Provider Secondary Practice Location Address- Country CodepracticeLocations[n].country_code 
8Provider Secondary Practice Location Address- Telephone NumberpracticeLocations[n].telephone_number 
9Provider Secondary Practice Location Address- ExenstionpracticeLocations[n].telephone_numberStored with Telephone Number in Telephone Number field.
DERVIVED VALUEpracticeLocations[n].country_nameDerived From Country Code