Sign in
latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Practitioner

List hospital affiliations for a practitioner

Returns the hospital affiliations recorded for the specified practitioner. Source values are normalized to canonical short labels: MANUAL, ROSTER, or CAQH. Use this to retrieve all hospital affiliations linked to a practitioner record; this endpoint is feature-gated, and if the hospital affiliations feature is not enabled for the tenant, the server returns 403. {practitionerId} is the certifyPractitionerId, and the hospital affiliations feature must be enabled for the tenant.

get/practitioners/{practitionerId}/hospital-affiliations

Path parameters

practitionerIdstring required

Headers

tenant-idstring

Response

Hospital affiliations for the practitioner

idstring required

Stable UUID v4 identifying this affiliation. For legacy entries this may be a deterministic synthesized UUID until the next write backfills a real one.

namestring

Hospital name

typestring

Type of affiliation

specialtystring

Specialty practiced at the hospital

statestring

State where hospital is located

source'MANUAL' | 'ROSTER' | 'CAQH'

Source-of-truth tag for a practitioner-level hospital affiliation. Accepts MANUAL, ROSTER, CAQH (any case), or the legacy long-form CAQH label. Always serializes the canonical short label.

startDatestring

Start date of affiliation in YYYY-MM-DD format

endDatestring

End date of affiliation in YYYY-MM-DD format

statusstring

Status of the affiliation

Example response

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "General Hospital",
    "type": "Admitting",
    "specialty": "Cardiology",
    "state": "NY",
    "startDate": "2026-01-01",
    "endDate": "2027-12-31",
    "status": "Active"
  }
]