Tasks (v3)
Minimum CorEMR Version: 6.4.0
This webservice allows clients to manage patient information inside the CorEMR system. It can be used to retrieve and edit patient tasks, as well as all of their applicable fields and data.
Task Endpoints
Action
REST Verb
Route
Description
Read
GET
/ws/v3/tasks/
Gets list of all tasks currently in the system.
Read
GET
/ws/v3/patients/{external_id}/tasks/
Get all tasks on the specific patient with the given external_id
Read
GET
/ws/v3/patients/{external_id}/tasks/{task_id}
Get a specific task with the given id on the patient with the given external_id
Create
POST
/ws/v3/patients/{external_id}/tasks/
Create a new task on the patient with the given external_id.
Update
POST
/ws/v3/patients/{external_id}/tasks/{task_id}
Update an existing patient task.
GET Return Fields
Return Field
Datatype
Filter
Note
id
Integer
Unique task identifier.
external_id
String
Unique patient identifier correlating to the patient this task is assigned to.
description
String
Description of the task.
category_name
String
Category of task.
task_category_id
Integer
Category number of task.
priority
Integer
Priority category number of task.
task_category_id
Integer
Category number of task.
scheduled_date
DateTime
Date the task should be completed as a string, formatted as YYYY-MM-DD 00:00:00.000
status
Integer
Status number of task.
created_date
DateTime
Creation date of task as a string, formatted as YYYY-MM-DD 00:00:00.000
created_user
String
User's name who created the task
category_user_id
Integer
User's ID number who created the task
POST Fields
Field
Datatype
Required
Default
Notes
facility
Integer
Patient's facility
Facility number where the patient task needs to happen.
booking_no
String
Booking number of the patient the task is being placed on.
description
String
String description of the task.
date_start
DateTime
Date the task begins. Formatted in ISO8601 format.
date_end
DateTime
Date the task ends. Formatted in ISO8601 format.
facility_created
Integer
O
Facility or patient's facility
Facility number where the patient alert is being created.
priority
Integer
O
3
Priority of completion of the task, with 1 being highest priority.
all_day
Boolean
O
FALSE
Flag indicating whether the task lasts all day, 1 for all day, 0 for set time.
locked
Boolean
O
FALSE
Flag indicating whether the task is locked, 1 for yes, 0 for no.
facility_completed
Integer
O
Facility number where the patient task is completed.
order_id
Integer
O
ID number of the order the task came from.
category_id
Integer
O
The category number correlating to the task type. (See /ws/v3/records/tasks/
)
provider_id
Integer
O
ID number of the provider of the patient.
related_record_name
String
O
Name of record to be referred to in relation to the task.
related_type
Integer
O
The category number correlating to the related type.
source_related_id
Integer
O
Internal field, do not alter unless understood.
result
Integer
O
Status number indicating the result of the task (See table below).
related_id
Integer
O
ID number of related record.
note
String
O
Note to be attached to the task.
generator_id
Integer
O
ID number of the generator that created the task.
date_removed
DateTime
O
Date the task was removed from the patient. Formatted in ISO8601 format.
treatement_id
Integer
O
ID number of the treatment that the task refers to.
Result Codes
Code
Name
1
Complete
Task was completed as requested.
2
Refused
Patient refused to allow the user to accomplish the task.
3
Absent
Patient was absent.
4
Rescheduled
Task was rescheduled to a different date.
5
Not Completed
Task was not completed.
6
Canceled
Task was cancelled/deleted in system.