Problems

The Problems feature allow the user to document a new identified health issues of the patient, modify an existing list or retrieve list of problems or delete the list of problems specific to a patient. The Problem Changed Subscription feature will allow the user to retrieve changes made to the Problems chart to the data (not including any deleted information). For more information about subscriptions, please refer Changed Data Subscriptions.

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Add problem to patient's problem list
POST
/v1/{practiceid}/chart/{patientid}/problems

Records a problem in the patient's active problem list

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid
patientid integer patientid
Content-Type string Content type of the payload

Output Parameters

Expand all
errormessage string If the operation failed, this will contain any error messages.
problemid integer If successful, the athena ID of the newly created problem
success string Whether the operation was successful or not.
Example Code
Get patient's problem list
GET
/v1/{practiceid}/chart/{patientid}/problems

Retrieves patient's active problems list

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid
patientid integer patientid
showinactive boolean Also show inactive (but not soft deleted) problems.
departmentid integer The athenaNet department id.
showdiagnosisinfo boolean If true, will include every encounter and associated diagnosis with each problem. Also fills the bestmatchicd10code field with the best conversion from the problem SNOMED code to ICD10 code if there is no user-selected ICD10 code in an encounter diagnosis event. Please note that the bestmatchicd10code may not always be accurate.
THIRDPARTYUSERNAME string User name of the patient in the third party application.
PATIENTFACINGCALL boolean When 'true' is passed we will collect relevant data and store in our database.

Output Parameters

Expand all
lastmodifiedby string The username of the user who last modified the note, no known problems checkbox, or problems.
lastmodifieddatetime string The date and time the note, no known problems checkbox, or problems were last updated.
lastupdated string Deprecated, used LASTMODIFIEDDATETIME instead. The last date any of the problems in the returned list were updated. Does not include no known problems or the section note, and is date precision.
noknownproblems string Whether the no known problems checkbox is checked. This is an explicit statement separate from a patient who has no documented problems so far.
notelastmodifiedby string The username of the user who last modified the note.
notelastmodifieddatetime string The date and time the section note was last updated.
problems array List of problems, grouped by problem code
sectionnote string The problem section note
totalcount integer Total number of problems
Example Code
Update patient's problem list
PUT
/v1/{practiceid}/chart/{patientid}/problems

BETA: Modifies the section-note and noknownproblems fields for the patient problem

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid
patientid integer patientid
Content-Type string Content type of the payload

Output Parameters

Expand all
errormessage string If the operation failed, this will contain any error messages.
success string Whether the operation was successful.
Example Code
Update patient's problem details
PUT
/v1/{practiceid}/chart/{patientid}/problems/{problemid}

Modify the information of a specific patient's problem

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid
patientid integer patientid
problemid integer problemid
Content-Type string Content type of the payload

Output Parameters

Expand all
errormessage string If the operation failed, this will contain any error messages.
success string Whether the operation was successful.
Example Code
Remove a problem from patient's problem list
DELETE
/v1/{practiceid}/chart/{patientid}/problems/{problemid}

Delete an problem from the patient's active problem list

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid
patientid integer patientid
problemid integer problemid
remove boolean Set this to true if a problem was added in error. It will remove the problem from the chart permanently.
departmentid integer The athenaNet department id.

Output Parameters

Expand all
errormessage string If the operation failed, this will contain any error messages.
success string Whether the operation was successful.
Example Code
Get list of problems change events to which you can subscribe
GET
/v1/{practiceid}/chart/healthhistory/problems/changed/subscription/events

Retrieves the list of events that can be input for the Problems Changed subscription

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid

Output Parameters

Expand all
status string Will return one of following statuses: ACTIVE, INACTIVE, or PARTIAL. The PARTIAL status means that not all events are subscribed to. In the event of a problem, UNKNOWN may be returned.
subscriptions array List of events you are subscribed to.
Example Code
Subscribe to all/specific change events for problems
POST
/v1/{practiceid}/chart/healthhistory/problems/changed/subscription

Subscribe for changed problem events

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid
Content-Type string Content type of the payload

Output Parameters

Expand all
success string Returns if the call to manipulate subscriptions for problem was successful.
Example Code
Get list of problems change subscription(s)
GET
/v1/{practiceid}/chart/healthhistory/problems/changed/subscription

Retrieves list of events for Problems

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid

Output Parameters

Expand all
status string Will return one of following statuses: ACTIVE, INACTIVE, or PARTIAL. The PARTIAL status means that not all events are subscribed to. In the event of a problem, UNKNOWN may be returned.
subscriptions array List of events you are subscribed to.
Example Code
Get list of changes in problems based on subscribed events
GET
/v1/{practiceid}/chart/healthhistory/problems/changed

Retrieves list of modified problems for a patient

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid
leaveunprocessed boolean For testing purposes, do not mark records as processed
showprocessedenddatetime string See showprocessedstartdatetime
patientid array Patient ID. Multiple Patient IDs are allowed, either comma separated or with multiple values.
showprocessedstartdatetime string Show already processed changes. This will show changes that you previously retrieved at some point after this datetime mm/dd/yyyy hh24:mi:ss (Eastern). Can be used to refetch data if there was an error, such as a timeout, and records are marked as already retrieved. This is intended to be used with showprocessedenddatetime and for a short period of time only. Also note that all messages will eventually be deleted.
limit integer Number of entries to return (default 1500, max 5000)
offset integer Starting point of entries; 0-indexed

Output Parameters

Expand all
code string Problem code
codeset string Problem codeset (SNOMED, ICD9, ICD10, etc)
events array List of start and stop events for this problem, which can occur multiple times.
name string Problem name
patientid integer Patient ID associated with this problem.
problemid integer Athena ID for this problem
Example Code
Unsubscribe to all/specific change events for problems
DELETE
/v1/{practiceid}/chart/healthhistory/problems/changed/subscription

Delete an specific event which is no longer required

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid
eventname string By default, you are unsubscribed from all possible events. If you only wish to unsubscribe from an individual event, pass the event name with this argument.

Output Parameters

Expand all
success string Returns if the call to manipulate subscriptions for problem was successful.
Example Code