Quality Measures

Quality Management contains both pay for performance (P4P) programs from different insurance providers as well as clinical guidelines. The list of programs, measures, and results are always in reference to a specific patient and provider. If a provider is not specified, the default provider is used (which is usually the provider that has seen this patient the most often). The system generally recalculates the measure results each morning, if the patient has an appointment that day or if the system detects a change in the patient data. This means that any changes to the patient chart or current encounter may not be reflected in the results. Users can manually force a refresh of the measure results. When this happens, two processes are launched. A synchronous one that only refreshes the results for the given provider, which will be current once the update call returns, and an asynchronous one for all providers. As these measure calculations are resource intensive, the system prevents you from running a refresh more often than once a minute. Please get the last refresh time to see if you actually need to refresh the patient data. The last refresh time is updated only after the full asynchronous call completes. There is another rate limiter that prevents users from running the refresh (it will return with a failure) as each run locks the patient for 18 seconds. The refresh can take a while on older (low practice ID) and larger practices, so please be patient. The results can have multiple statuses, including Needs Work, Satisfied, Satisfied (but can be Due Soon), Not Satisfied (but can be Out of Range so fixable), Excluded, or Snoozed. Only clinical guideline measures can be snoozed. The results can be filtered on whether it's a P4P or Clinical Guidelines measure, as well as two status categories -- All or Needs Attention. Needs Attention results include the statuses of Needs Work, Satisfied (Due Soon), or Not Satisfied (Out of Range). The remaining ones are part of 'All'.

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Get quality measures for given patient
GET
/v1/{practiceid}/chart/{patientid}/qualitymanagement
Retrieves the list of quality measures for a given provider
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
status string Optional filter to only get results with this status
departmentid integer The athenaNet department id.
providerid integer The ID of the provider. If not specified, the default provider is used -- usually the provider that has seen the patient most often / recently.
measuretype string Optional filter to only get clinical guidelines or pay for performance results.
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
canonicalname string The canonical name of the QM measure displayed in the UI.
description string A long description for this measure.
duedate string The date this measure is next due. This can be a description like 'Past Due' and not just a date.
lastresultdate string The date of the most recent clinical data that affected this measure's outcome.
measureid integer The athenaID for this measure.
measurename string The name of the measure. Note that a given measure may show up multiple times under different programs.
measureshortname string A shorter version of the name for this measure, suitable for display.
measuretype string Either 'Clinical Guideline' or 'Pay for Performance'. The latter are sourced from different insurance providers.
note string The note added to the QM measure.
programname string The name of the program this measure belongs to.
status string The status of this measure. The valid values are NOTSATISFIED (either can no longer be fulfilled or has data that fails the measure), SATISFIED, NEEDSWORK, EXCLUDED, or SNOOZED (only possible for Clinical Guidelines).
statustext string A texual description for the status, often with additional information.
Example Code
Get last created/refresh time of patient's quality measure
GET
/v1/{practiceid}/chart/{patientid}/qualitymanagement/refresh
Retrieves the data and time of the last refresh of patient's quality measures
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
lastrefresh string The last time this patient's quality management measures data was refreshed.
Example Code
Refresh quality measures for given patient
POST
/v1/{practiceid}/chart/{patientid}/qualitymanagement/refresh
Refreshes a patient's quality measure records
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 or not.
Example Code
Get quality measures for given patient
GET
/v1/{practiceid}/chart/{patientid}/qualitymanagement
Retrieves the list of quality measures for a given provider
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
status string Optional filter to only get results with this status
departmentid integer The athenaNet department id.
providerid integer The ID of the provider. If not specified, the default provider is used -- usually the provider that has seen the patient most often / recently.
measuretype string Optional filter to only get clinical guidelines or pay for performance results.
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
canonicalname string The canonical name of the QM measure displayed in the UI.
description string A long description for this measure.
duedate string The date this measure is next due. This can be a description like 'Past Due' and not just a date.
lastresultdate string The date of the most recent clinical data that affected this measure's outcome.
measureid integer The athenaID for this measure.
measurename string The name of the measure. Note that a given measure may show up multiple times under different programs.
measureshortname string A shorter version of the name for this measure, suitable for display.
measuretype string Either 'Clinical Guideline' or 'Pay for Performance'. The latter are sourced from different insurance providers.
note string The note added to the QM measure.
programname string The name of the program this measure belongs to.
status string The status of this measure. The valid values are NOTSATISFIED (either can no longer be fulfilled or has data that fails the measure), SATISFIED, NEEDSWORK, EXCLUDED, or SNOOZED (only possible for Clinical Guidelines).
statustext string A texual description for the status, often with additional information.
Example Code