v1
latestOpenAPI 3.1.02026-08-063776831.4 MBValidate NPI
Validates the NPI format (Luhn checksum), then checks the CertifyOS DAL (sourceType=nppes) using the declared entity type to route to the correct core resource API. Falls back to the live NPPES public registry if not found. 'entityType' is an optional query parameter (case-insensitive); defaults to practitioner when omitted. Status VALID_FOUND_IN_NPPES_BUT_FAILED_CROSSWALK_CREATION indicates the NPI was found in NPPES but the DAL crosswalk upsert failed.
Query parameters
Entity type of the NPI: practitioner, facility, or group. Case-insensitive. Defaults to PRACTITIONER when omitted. Returns 400 if an unrecognised value is supplied.
Headers
Request body
Example request
{
"npi": "1234567890"
}Response
NPI is valid and found. Status is VALID_AND_FOUND (found in DAL), VALID_FOUND_IN_NPPES (found in live NPPES registry and crosswalk succeeded), or VALID_FOUND_IN_NPPES_BUT_FAILED_CROSSWALK_CREATION (found in live NPPES registry but DAL crosswalk upsert failed).
Example response
{
"npi": "1234567890",
"isValid": true,
"status": "VALID_AND_FOUND",
"providerDetails": {
"npi": "1023950565",
"nppes": [
{
"npi": "1023950565",
"active": true,
"firstName": "PAMELA",
"middleName": "S",
"lastName": "COKER",
"prefix": "",
"suffix": "",
"credential": "",
"gender": "",
"enumerationDate": "2026-04-06",
"lastUpdatedAt": "2026-04-06",
"certificationDate": "2026-04-06",
"enumerationType": "2",
"organizationId": "ELEVATE ILLINOIS HOME CARE LLC",
"addresses": [
{
"address1": "9239 KENNETH AVE",
"address2": "",
"city": "SKOKIE",
"state": "IL",
"postalCode": "600761617",
"addressPurpose": "",
"countryCode": "US",
"countryName": "US",
"phone": "773-710-5375",
"faxNumber": "773-710-5375",
"addressType": "mailing",
"telephoneNumber": "773-710-5375"
},
{
"address1": "9239 KENNETH AVE",
"address2": "",
"city": "SKOKIE",
"state": "IL",
"postalCode": "600761617",
"addressPurpose": "",
"countryCode": "US",
"countryName": "US",
"phone": "773-710-5375",
"faxNumber": "773-710-5375",
"addressType": "practice",
"telephoneNumber": "773-710-5375"
}
],
"taxonomies": [
{
"code": "253Z00000X",
"desc": "",
"license": "",
"primary": true,
"state": "",
"taxonomyGroup": ""
}
],
"identifiers": [],
"id": "",
"providerId": "",
"createdBy": "",
"createdByName": "",
"createdAt": "",
"updatedBy": "",
"updatedAt": "",
"status": "",
"verifiedAt": "",
"verifiedBy": "",
"verifiedDate": "",
"verifiedByName": "",
"source": "",
"credWorkflowRecordOrigin": "",
"otherNames": []
}
],
"emails": [],
"phoneNumbers": [],
"addresses": [],
"licenses": [],
"npdbReports": [],
"certifications": [],
"supportingDocuments": [],
"insurances": [],
"sanctions": [],
"specialties": [],
"accreditations": [],
"siteVisits": [],
"medicareStarRatings": [],
"appVerifications": [],
"performanceIndicators": [],
"lineOfBusiness": [],
"statesToCredential": []
}
}