Release Notes and Change Logs

athenaNet Release Schedule

athenaNet releases bug fixes and minor enhancement requests on a bi-weekly cadence. Production releases take place on Fridays followed by Preview releases on Saturdays. If you have submitted a request, we will notify you so you can verify the changes in Preview before it becomes available in Production. All other generic API changes will be noted below and made available immediately or on an as-needed basis.

Change Log 2021

    03.2021

    NOTICE: Please be aware of the following upcoming changes to our Social History endpoints with the 21.3 Release, happening 3/17/2021 through 3/19/2021:

    NOTICE: Endpoints: Patient social history. - GET /v1/{ practiceid }/chart/{ patientid }/ socialhistory & Patient social history. - PUT /v1/{ practiceid }/chart/{ patientid }/ socialhistory

    What is being Changed: The main goal of the New Social History Experience is to allow athenahealth to update Social History Content (Templates / Questions).

    • Structure of output remains the same; 
    • questiontext, questionkeys, templates, templateid, ordering, questionid fields' values may change more frequently in the new system as new content is rolled out.
    • questionid is being deprecated
    • templateid may not be unique

    Is this a breaking change: YES

    BREAKING CHANGE:

    1. socialhistorystatus was deprecated, it is now being removed as an output parameter from GET /chart/{patientid}/socialhistory
    2. We will now reject any PUT requests with invalid questions (i.e incorrect question keys) or invalid answers (answers that don’t conform to the correct input type defined per question). This change prevents invalid data from being saved in our system, which can cause errors downstream.

    What will current users of the endpoint need to update in their code:

    1. questiontext, questionkeys, templates can be added at any time. Code defensively, expecting that a question could be added or removed at any point. For example, some of the legacy questions have been removed.
    2. Questionid is being deprecated. API users should rely on the value of questionkey instead of questionid to uniquely identify a question. The questionid field will still be returned, but the value can change over time.  In a future release, the questionid field can be removed (as with any deprecated field)
    3. API users can no longer rely on socialhistorystatus.
    4. If API users rely on the value of templateid and encounter issues with the ID not being unique, they need to update the code because this value may not be unique and may change in the new release,
    5. Users will need to remove the invalid data causing the PUT request to rejected. In the error response, they can see which field is causing the error and whether it is an invalid type or an invalid value or an invalid question key.

    What will happen if changes are not made:

    1. The value of questionid for the same question can change at any time.
    2. any code that expects socialhistorystatus will throw an error
    3. PUT Requests with invalid questions or answers will be rejected with an error and until the invalid data is removed, socialhistory answers can’t be saved.

     

    **The rollout toggle releasing the New Social History Experience feature has been enabled for Preview 195900 so users may begin testing the new functionality of these endpoints against Preview Tablespace 195900.

     

    NOTICE: Endpoint: GET /v1/{practiceid}/chart/configuration/socialhistory

    What is being Changed: Templateids will change

    Is this a breaking change: No

    What will current users of the endpoint need to update in their code: No action needed

    What will happen if changes are not made: N/A

    NOTICE: Endpoint: GET /appointments/{appointmentid}/healthhistoryforms/{formid} & PUT /appointments/{appointmentid}/healthhistoryforms

    What is being Changed: The structure is the same. However, the Questions will change.

    Is this a breaking change: No

    What will current users of the endpoint need to update in their code: No action needed.

    What will happen if changes are not made: N/A

    NOTICE: Endpoint: Patient selected templates. - PUT /v1/{ practiceid }/chart/{ patientid }/ socialhistory /templates and Patient selected templates. - GET /v1/{ practiceid }/chart/{ patientid }/ socialhistory /templates

    What is being Changed: No change

    Is this a breaking change: No

    What will current users of the endpoint need to update in their code: No action needed.

    What will happen if changes are not made: N/A

    02.2021

    • We are now surfacing the Observation Identifier for lab analytes. The output parameter observationidentifier is the analyte code which is created by the external lab. The affected endpoints are: GET /patients/{patientid}/documents/labresult/{labresultid}, GET /chart/{patientid}/analytes, and GET  /chart/{patientid}/labresults. This is being made since the Observation Identifier that the external lab service uses can add benefit to API users allowing users to know exactly what analyte the external lab is populating. 
    • POST /riskgaps/condition was added to the Sandbox. The RiskGap API allows users to push external risk gaps (Chronic Conditions contributing to patient risk adjustment) into the athena EHR system.
    • GET /chart/{patientid}/obepisodes/{obepisodeid}/html fixed an unescaped character "<" that was causing some notes to be cut off and was causing other formatting issues.

    Change Log 2020

      12.2020

      • PUT /documents/imagingresult/{imagingresultid}/close was added to the Sandbox. This endpoint allows the user to advance an imaging result document to a closed status. 
      • PUT /documents/labresult/{labresultid}/close was added to the Sandbox. This endpoint allows the user to advance a lab result document to a closed status.

      11.2020

      • Removed all of the Patient Pay Vendor endpoints as these are still in development.
      • Removed the Fax System section from the Sandbox.
      • DELETE /chart/encounter/{encounterid}/encounterreasons was added to the Sandbox. This endpoint allows the user to delete an encounter reason from this encounter. The encounter reason to delete must be specified by its encounter reason id.
      • POST /chart/encounter/{encounterid}/encounterreasons was added to the Sandbox. This endpoint allows the user to add or update an encounter reason on this encounter. The encounter reason must be specified by ID. Use /configuration/encounterreaaons to get the full list of available encounter reasons.
      • POST /chart/encounter/{encounterid}/encounterreasonnote was added to the Sandbox. This endpoint allows the user to set or append text to the Encounter Reason Note. 
      • GET /configuration/encounterreasons was added to the Sandbox. This endpoint allows the user to retrieve the list of configured encounter reasons.
      • POST /encounter/{encounterid}/services has been updated to accept CPT codes (procedurecode) with the clinicalordertypegroup of "OTHER".

        10.2020

        • POST /patientpayvendors/{vendorcode}/changeageingownership was added to the Sandbox. This endpoint allows the user to update the Enrollment status of a Claim with a Patient Pay Vendor.
        • POST /patientpayvendors/{vendorcode}/payments was added to the Sandbox. This endpoint allows the user to record payments related to a patient.
        • POST /patientpayvendors/{vendorcode}/payments/{patientpaymentid}/refund was added to the Sandbox. This endpoint allows the user to record refunds related to a patient.
        • PUT /patients/{patientid}/documents/orders/referral/{referraldocumentid}/close was added to the Sandbox. This endpoint allows the user to close a referral order.
        • PUT /patients/{patientid}/documents/orders/referral/{referraldocumentid}/reopen was added to the Sandbox. This endpoint allows the user to reopen a referral order. When reopening a referral order, the status will be returned to SUBMIT.

          09.2020

          • GET /chart/{patientid}/allergies will now contain the key “categories” which will be an array of 0 to 3 categories, specifically “environment,” “food,” and “medication,” as applicable.
          • POST /patientpayvendors/{vendorcode}/statements was added to the Sandbox. This endpoint allows the user to update the age of claims for patients when statements are sent to them under the Patient Pay vendor.

          08.2020

          • POST /patientpayvendors/{vendorcode}/patientenrollment was added to the Sandbox. This endpoint allows the user to update the Enrollment status of a Patient with a Patient Pay Vendor.

          07.2020

          • GET /appointments/getappointmentidbyhash/{messagehash} was added to the Sandbox. This endpoint allows the user to get the appointment id from an appointment confirmation message hash.
          • When the “showallergentranslations” flag is set to TRUE for GET /chart/{patientid}/allergies, this endpoint will now include any available translations of the allergen code for each of the allergies on a patient’s chart, including “No Known Allergies”.

          06.2020

          • POST /appointments/expedited was added to the Sandbox. This call will create an appointment and complete the check-in process. In order to use this endpoint, the practice setting 'Expedited Encounters and Deferred Insurance' must be configured.
          • POST /vitals/observations was removed from the the Sandbox.

          05.2020

          • GET /personalpronouns was added to the Sandbox. This API is used to get the mapping of personal pronouns id to display name.
          • PUT /documents/labresult/{documentid}/dataentrycompleted was added to the the Sandbox. This endpoint is used to apply a document action on a specific lab result document.

          02.2020

          • POST /patients/{patientid}/patientsecuremessage/marklabresultread/{messagethreadid} was added to the Sandbox. This API updates the specified LabResult has been read by the patient or a family member on the Patient Portal.

          Change Log 2019

          06.2019

          • GET /patients/{patientid}/insurances will provide insurancepackageID information
          • Update appointment tickler ("appointment reminder") PUT & DELETE endpoints to allow modification by API for ticklers created by another user

          05.2019

          • BillingNDC parameter added to GET /v1/{practiceid}/patients/{patientid}/documents/prescription/{prescriptionid}
          • When the user runs the Request API - GET /v1/{practiceid}/chart/{patientid}/labresults, the output should expose additional parameters.
            • "exactduplicatedocumentid" 
            • "supersededdocumentid"
          • GET /chart/{patientid}/vaccines will surface "deletedate" when parameter "showdeleteted" = True.

          04.2019

          • GET /configuration/ordersets now returns the ICD10 codes, clinical provider name, and clinical provider id configured for each order set.
          • POST /providers allows for selecting supervising provider as 'SELF'.
          • GET /appointments/changed now surfaces appointment notes.
          • Output parameters of GET /encounter/{encounterid}/orders/{orderid} and GET /{patientid}/documents/order/{orderid} have been consolidated.
          • Fix messages returned for a deleted patient.
            • When the Patient ID is soft-deleted within the context then display the message:“This patient id has been deleted from this context.”
            • When the Patient ID is invalid (i.e.: no patient with that ID exists in the context, in any status) then display the message: “This patient does not exist in this context.

           

          03.2019

          • GET /orders/changed can be filtered by order type, provider id, and clinical provider id/facility id.
          • GET /patients/changed will correctly return the patient's enterprise id instead of the athenaNet local id athenaNet localID when parameter 'returnglobalid' is set to TRUE.
          • The output of GET /orders/changed will now expose modality codes.

          02.2019

          • GET /patients/{patientid} will correctly return the insurance data associated with a patient's local id.
          • The following changed data subscriptions can now be filtered by department id and/or patient id (passed in as a JSON or comma-separated list):
            • GET /ccmenrollmentstatus/changed
            • GET /chart/healthhistory/medication/changed
            • GET /claims/changed
            • GET /appointments/changed
            • GET /patients/changed
          • The POST /patients/{patientid}/documents/encounterdocument call will accept an enterprise id as the patient id and translate it to the appropriate local patient id.
          Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others

          On this Page