Skip to content

Patients (v3)

Minimum CorEMR Version: 6.4.0

Patients

This webservice allows clients to manage patient information inside the CorEMR system. It can be used to retrieve and edit patients, as well as all of their applicable fields and data.

Patient Endpoints

Action REST Verb Route Description
Read GET /ws/v3/patients/ Gets list of non-deleted patients current in the system.
Read GET /ws/v3/patients/{external_id} Get details on specific patient with given external_id
Create POST /ws/v3/patients/ Create a new patient.
Update POST /ws/v3/patients/{external_id} Update an existing patient.

GET Return Fields

/ws/patients/
Return Field Datatype Filter Note
external_id String Unique Patient Request identifier.
facility String ✅ String representation of patient facility. Note that this is different from the post facilty field, which requires the integer ID representation of the facility.
agency Integer ✅ Jail agency.
agency_id String Jail agency's string identifier.
fname String ✅ Patient first name.
mname String ✅ Patient middle name.
lname String Patient last name.
dob DateTime ✅ Patient's data of birth, formatted as YYYY-MM-DD 00:00:00.000
sex String ✅ Patient's sex assigned at birth.
allergies String List of known patient allergies.
ssn String Patient social security number.
race String Patient race.
ethnicity String Patient ethnicity.
height integer Patient height in inches.
weight String Patient weight in pounds.
eye_color String Patient eye color.
hair_color String Patient hair color.
address1 String Patient's primary address.
address2 String Patient's secondary address.
city String Patient's city correlating to address1
state String Patient's state correlating to address1
zipcode String Patient's zipcode correlating to address1
custom1 - custom9 String Setup by client within CorEMR.

POST Fields

Field Datatype Required Default Notes
external_id String ✅ Unique Patient Request identifier.
facility Integer ✅ Location where patient is to be admitted.
agency Integer O Default Jurisdiction Jail Agency
billing_agency Integer O Default Billing Agency used for billing when sent to pharmacy.
fname String ✅ Patient first name
lname String ✅ Patient last name
sex String ✅ Patient sex assigned at birth, 'M' or 'F'
dob DateTime ✅ Patient date of birth. Formatted in ISO8601 format.
booking_no String ✅ Patient booking number
booking_date DateTime ✅ Patient booking date. Formatted in ISO8601 format.
ssn String O Patient Social Security Number
agency_id String O ID at patient's jurisdictional agency.
billing_id String O ID at patient's billing agency.
aka String O Patient nickname
mname String O Patient middle name
work_status String O Patient work status
language String O Patient primary language
race String O
address String O Patient primary residence
photo_link Filepath O Filepath to patient photo
eye_color String O
hair_color String O
body_build String O
skin_tone String O
citizenship String O
military_branch String O
education_level String O
religion String O
infirmary Boolean O Flag indicating whether patient is in the infirmary, 1 for yes, 0 for no.
inf_level Integer O Level of patient when in the infirmary
searchable Boolean O Flag indicating whether patient is searchable, 1 for yes, 0 for no.
height Integer O Height of patient in inches
weight Integer O Weight of patient in pounds
phone String O Primary phone of patient. Can include dashes if desired.
ethnicity String O Hispanic or Non-Hispanic
address2 String O Secondary street address for patient
city String O City of primary patient residence
state String O State of primary patient residence
zipcode String O Zipcode of primary patient residence
birth_country String O Patient country of birth
mother_fname String O Patient's Mother's first name
mother_mname String O Patient's Mother's middle name
mother_lname String O Patient's Mother's last name
mother_maiden String O Patient's Mother's maiden name
current_location String O Patient's current location
assigned_location String O Patient's assigned location. Note that a separator value must be used and be unique and consistant through

Patient Bookings

Booking Endpoints

Action REST Verb Route Description
Read GET /ws/v3/patients/{external_id}/bookings/ Get list of patient bookings for specified patient.
Read GET /ws/v3/patients/{external_id}/bookings/{number} Get details on specified patient booking.
Create POST /ws/v3/patients/{external_id}/bookings/ Create an assigned patient booking.
Update POST /ws/v3/patients/{external_id}/bookings/{number} Update an existing patient booking.

GET Return Fields

/ws/patients/{external_id}/bookings/
Return Field Datatype Filter Note
facility String ✅ String representation of patient facility. Note that this is different from the post facilty field, which requires the integer ID representation of the facility.
number String Booking number.
date String ✅ Booking's creation date as a string, formatted as YYYY-MM-DD 00:00:00.000
active Integer ✅ Boolean stating whether the booking is currently active or not. 0 for false, 1 for true
release String ✅ Booking's end date as a string, formatted as YYYY-MM-DD 00:00:00.000
temporary Integer ✅ Boolean stating whether the booking is temporary or not. 0 for false, 1 for true

POST Fields

Field Datatype Required Default Notes
booking_no String ✅ Unique patient booking identifier.
date DateTime ✅ Patient booking date. Formatted in ISO8601 format.
active Boolean O FALSE Flag indicating whether the booking is currently active, 1 for yes, 0 for no.
facility String O Patient's facility Facility the booking is set for.
temporary Boolean O FALSE Flag indicating whether the booking is temporary, 1 for yes, 0 for no.
facility_created String O Facility or patient's facility Facility the booking was created in.
facility_completed String O Facility the booking was completed in.
release DateTime O Patient booking release date. Formatted in ISO8601 format.

Photos

This webservice allows adding a new image to use on the patient's chart as their photo.

Photo Endpoints

Action REST Verb Route Description
Add POST /ws/v3/patients/{external_id}/photos/ Adds a new photo to use for the patient's current photo. Old photos are not retained.

POST Fields

Field Datatype Add Read Notes
blob String ✅ Base64-encoded image in JPEG, PNG, or GIF format.