Medical History

The Medical History feature allows the user to retrieve or update information about the patient's medical conditions. The Medical History Reference will allow the user to retrieve the configured medical history question in the system.

MEDICAL
The past medical history section is the simplest section type. It consists of a list of checkbox questions. 

  • 'DEFAULT' is the Y/N checkbox that indicates whether the patient had this condition before.
  • 'pastmedicalhistoryquestionid' ties it to the practice-specific medical history question and can be used to tie the same question across multiple forms.
  • 'text' is the patient-friendly name of the medical history question.
Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit

Endpoints

Get patient's medical history data

GET
/v1/{practiceid}/chart/{patientid}/medicalhistory
Retrieves medical history of a specific 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
patientid integer patientid
departmentid integer The athenaNet department ID.

Output Parameters

Expand all
notelastmodifiedby string Username that last modified Medical History note. This API attribute is being rolled out and will be Generally Available on or before July 1, 2022.
notelastmodifieddatetime string Date and time Medical History note was last modified. This API attribute is being rolled out and will be Generally Available on or before July 1, 2022.
questions array List of questions corresponding to patient medical history
sectionnote string Additional notes for the entire medical history section, if any
Example Code

Update patient's medical history data

PUT
/v1/{practiceid}/chart/{patientid}/medicalhistory
Updates the medical history of a specific 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
patientid integer patientid
Content-Type string Content type of the payload

❙ Request Body

Expand all
departmentid integer The athenaNet department ID.
questions array A complex JSON object containing the patient medical history. See the Chart documentation for more details.
sectionnote string Any additional section notes

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 medical history questions used by this practice

GET
/v1/{practiceid}/chart/configuration/medicalhistory
Retrieves the list of medical history questions
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
showdeleted boolean Include deleted questions
limit integer Number of entries to return (default 1000, max 10000)Please note that this endpoint has a different default and max than normal.
offset integer Starting point of entries; 0-indexed

Output Parameters

Expand all
deleted string True if this question has been deleted
diagnosiscode string Diagnosis code for the disease, if provided
ordering number Used for re-ordering questions
question string Disease being inquired about
questionid number Athena ID for the question
Example Code