v1

latestOpenAPI 3.1.02026-08-063776831.4 MB

Practitioner

Create a hospital affiliation for a practitioner

Creates a new hospital-affiliation entry on the practitioner record. The server assigns a stable UUID v4 and returns the full HospitalAffiliationResponse as the body. No Location header is set, matching the existing PractitionerResource POST convention.

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

Created

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