Create or Update Patient

PUT /public/v1/patients

Create or Update Patient

cURL

curl --request PUT \
  --url https://app.silnahealth.com/api/public/v1/patients/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "date_of_birth": "2023-12-25",
  "source_id": "<string>",
  "patient_specialties": [],
  "provider_service_location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "provider_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "address_line_1": null,
  "address_line_2": null,
  "city": null,
  "state": null,
  "zip_code": null,
  "sex": null
}
'

200

{
  "patient_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Behavior Overview

This API has two flows: update and create. We trigger the update flow if we find a patient with a matching source_id or we determine the requested patient to be a duplicate (for example, they have the same first name, last name, and dob as an existing patient). Else we trigger the create flow.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

first_name · string · required

Patient's first name

last_name · string · required

Patient's last name

date_of_birth · string<date> · required

Patient's date of birth

source_id · string · required

Patient's EHR ID (or other unique identifier) that you have in your system

patient_specialties · enum<string>[] · required

Patient's specialties. A patient can have multiple

Available options: PHYSICAL_THERAPY, ABA_THERAPY, SPEECH_THERAPY, OCCUPATIONAL_THERAPY, PSYCHOLOGICAL_TESTING, HOME_HEALTH_CARE, HOSPICE, CARDIAC_REHABILITATION, INTENSIVE_CARDIAC_REHABILITATION, MENTAL_HEALTH, PRINCIPAL_ILLNESS_NAVIGATION, PRINCIPAL_CARE_MANAGEMENT, ADVANCED_PRIMARY_CARE_MODELS, PREVENTATIVE_HEALTH, PARTIAL_HOSPITALIZATION_PROGRAM, INTENSIVE_OUTPATIENT_PROGRAM, INTERVENTIONAL_RADIOLOGY, VASCULAR_SURGERY, INTERVENTIONAL_CARDIOLOGY, ORTHOPEDICS, CHIROPRACTIC, GYNECOLOGY, LONG_TERM_CARE, NUTRITIONAL_COUNSELING, PHYSICAL_MEDICINE, PULMONARY_REHABILITATION, INJECTABLE_SPECIALTY_MEDICATIONS, ALLERGY_TESTING, SKILLED_NURSING, RADIOLOGY, OTOLARYNGOLOGY, DURABLE_MEDICAL_EQUIPMENT, DERMATOLOGY, PROFESSIONAL_OFFICE_VISIT

status · enum<string> · required

Patient's status

Available options: INTAKE, ACTIVE, DISCHARGED, ON_HOLD

provider_service_location_id · string<uuid> · required

Provider Service Location ID (where the patient receives service)

provider_id · string<uuid> · required

address_line_1 · string | null

Patient's street address

Maximum string length: 255

address_line_2 · string | null

Patient's apartment, suite, unit, etc.

Maximum string length: 255

city · string | null

Patient's city

Maximum string length: 255

state · string | null

Patient's state

Maximum string length: 255

zip_code · string | null

Patient's zip code. Empty strings are not allowed

sex · enum<string> | null

Patient's sex

Available options: MALE, FEMALE

Response

200

application/json

patient_id · string<uuid> · required