latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Practitioner

Retrieve a single practitioner by ID

Returns the full practitioner record for the specified certifyPractitionerId. Use this when you have a known certifyPractitionerId and need the complete practitioner data object; to search across practitioners by name, NPI, or other attributes, use GET /practitioners instead, and for relationship data such as groups, networks, or locations, see the /relationships/* sub-resources. {id} is the certifyPractitionerId assigned at creation; include the X-PII-View: true header to receive PII fields, which requires the practitioner read:pii permission. Which fields are actually withheld or nulled when PII is not requested is decided entirely by the downstream data-access layer — api-layer only forwards the flag and enforces the permission gate. This response never includes an ssn field; the SSN is exposed only via GET /practitioners/{id}/ssn. terminationDate and terminationReason are present only if the practitioner has been terminated (e.g. via PUT /practitioners/terminate); absent otherwise.

get/practitioners/{id}

Path parameters

idstring required

Practitioner ID

Headers

X-PII-Viewstring

Include PII in response; requires explicit permission

tenant-idstring

Response

The practitioner's full profile data, including PII fields when requested via X-PII-View.

prefixstring
firstNamestring
caqhPrimaryEmailstring
middleNamestring
lastNamestring
suffixstring
primaryEmailstring
npistring
externalIdstring
enrollmentStartDatestring date
reimbursementIdstring
supervisingPractitionerIdstring
caqhProviderIdstring
providerTypestring[]
practitionerTypestring[]
practitionerSpecializedTrainingstring[]
practitionerTypesToCredentialstring[]
reviewCompleteDatestring date
statesToCredentialstring[]
practitionerRolesstring[]
practitionerRolesMapobject
lineOfBusinessstring[]
providerIdstring
dateOfBirthstring date
ssnstring
genderstring
racestring
ethnicitystring
providerCreatedDatestring date
npdbDatabankSubjectIdstring
npdbDcnstring
isDeceasedboolean
deceasedDatestring date
deceasedExplanationstring
lastCredentialedDatestring date
lastCredentialingDatestring date
nextCredentialingDatestring date
initialCredentialingDatestring date
dataAcquireDatestring date
sourceUpdateDatestring date
userDefinedFieldsobject
delegationStatus'Delegated' | 'Direct' | 'CredNotRequired'
jurisdictionOfIntereststring
sanctionsLineageobject
idstring
crosswalkIdstring
credentialingStatusstring nullable

Credentialing status from the latest credentialing workflow

credentialingDueDatestring nullable

Credentialing due date from the latest credentialing workflow (as string). Serialized as credentialingDueDate; populated by CP-32265 from the top-level credentialingDueDate emitted by the DAL. Output-only (not bound on request deserialization).

terminationDatestring nullable

Termination effective date (YYYY-MM-DD), present only if the practitioner has been terminated

terminationReasonstring nullable

Termination reason, present only if the practitioner has been terminated