latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Practitioner

Add a hospital affiliation to a practitioner

Creates a new hospital affiliation entry on the practitioner record; the server assigns a stable UUID v4 as the affiliation identifier and returns the full affiliation in the response body. Use this when a practitioner gains a new hospital affiliation that needs to be recorded; no Location header is returned in the 201 response, so use the id field in the response body to reference the created affiliation. {practitionerId} is the certifyPractitionerId, and the hospital affiliations feature must be enabled for the tenant (403 returned if not). Only name and type are required; all other fields are optional, and endDate must be on or after startDate when both are supplied.

post/practitioners/{practitionerId}/hospital-affiliations

Path parameters

practitionerIdstring required

Headers

tenant-idstring

Request body

namestring required

Hospital name

typestring required

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 date

endDatestring date

statusstring

Status of the affiliation

Example request

{
  "name": "General Hospital",
  "type": "Admitting",
  "specialty": "Cardiology",
  "state": "NY",
  "startDate": "2022-03-10",
  "endDate": "2022-03-10",
  "status": "Active"
}

Response

The full HospitalAffiliationResponse, including the server-assigned id.

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"
}