Problem Flowsheets

Partners can use Flowsheet GET APIs to retrieve patient-level flowsheet data (vitals, medications, and lab analytes) for problem flowsheets. Partners will also be able to retrieve flowsheet configurations for a given problem at practice-level and provider-level. This will allow partners to chart trends for clinical elements associated with individual problems.

What are Flowsheets? 

Flowsheets provide a centralized place in the patient's chart to track a variety of information pertaining to a particular problem over time. Although athenaNet has flowsheets for several aspects of the patient chart, this particular set of APIs exposes flowsheets for patient problems.

Note: APIs only support flowsheets for contexts that are on Streamlined. Streamlined is an experience mode for athenaNet that provides intuitive navigation and easy-to-use workflows, allowing practice users to better manage patient care. We are in the process of migrating all clients to Streamlined from what is called Classic mode. Due to the fundamental differences in how flowsheets are organized, APIs do not fully support Classic mode. The following practiceinfo API now returns experiencemode. Problem flowsheets should be fully functional in StreamlinedOnly, Streamlined & Classic and Legacy Streamlined modes.

Flowsheet configurations

Flowsheets can be categorized into two types – global flowsheets and user-defined flowsheets. Global flowsheets are pre-configured flowsheets that are available for all contexts, whereas user-defined flowsheets are directly linked to the user and are only available for a given context, for the specific user, for any patient. Another difference is that global flowsheets may contain header elements – any historical questions that provide additional information pertaining to the particular problem. Generally, these are social history questions, but text-fields are available too.

Flowsheets can be configured to contain any vitals, medications and analytes.

Flowsheet APIs

The following APIs are built to allow partners view flowsheet information.

Returns global-level/provider-level flowsheet configuration, containing a list of clinical elements being tracked for a given problem. Optional parameters include:

  • ProviderID: A list of comma separated providerIDs which can be passed for a combined clinical element list.
    • If no providerID is passed in, the API returns Global configuration
    • A departmentID is required when passing providerID
  • Returns patient-level flowsheet data for a given problem. Optional partameters include:
    • ProviderID: A list of providerIDs which can be passed to return data based on provider specific configurations.
      • If no providerID is passed, then the API uses the primaryproviderID of the patient. If a primary provider isn’t listed in patient’s chart, then data will be based on global template.
    • StartDate/EndDate: Fields to further filter the data being returned.
    • showglobalflowsheetelementsonly: When enabled, returns data for only the elements listed in global template.

Additional Information

  •  doesn’t return medications that aren’t manually configured by a user. These are medications relevant to the problem that are automatically added by athenaNet into the patient’s chart.
  • In athenaNet, medicationID is unique identifier for medications whereas analyteID and vitalID are not unique identifiers. Vitals are uniquely identified by clinicalelementID (and/or loinc-code) and analytes by name (and/or loinc-code).

Sample API Responses

API Call:

GET /chart/configuration/flowsheettemplates/596219000

Sample Response:

{
   "headers" : [
      {
         "elementkey" : "SOCIALHISTORY.DRUGS",
         "name" : "Illicit Drugs",
         "type" : "SOCIALHISTORY"
      },
      {
         "elementkey" : "Notes",
         "name" : "Notes",
         "type" : "TEXT"
      },
      {
         "elementkey" : "SOCIALHISTORY.SMOKING",
         "name" : "Smoking -How much?",
         "type" : "SOCIALHISTORY"
      },
      {
         "elementkey" : "Target Goals",
         "name" : "Target Goals",
         "type" : "TEXT"
      }
   ],
   "labanalytes" : [
      {
         "name" : "A1C"
      },
      {
         "name" : "Albumin, serum"
      },
      {
         "name" : "BUN"
      },
       {
         "name" : "HDL"
      },
      {
         "name" : "LDL"
      },
      {
         "name" : "Trig"
      }
   ],
   "medications" : [
      {
         "name" : "phentermine"
      },
      {
         "name" : "zolpidem"
      }
   ],
   "vitals" : [
      {
         "name" : "BP"
      },
      {
         "name" : "Height"
      },
      {
         "name" : "Weight"
      }
   ]
}

API Call:

GET /chart/20/flowsheets/59621000?departmentid=1&providerid=85&startdate=08/10/2015&enddate=05/01/2016
Sample Response
{
   "globalflowsheettemplateid" : "-466",
   "headers" : [
      {
         "analytename" : "HDL cholesterol",
         "chartdata" : [
            {
               "analytedate" : "12\/07\/2015",
               "analyteid" : "795596",
               "loinc" : "1188-6",
               "referencerange" : ">39",
               "units" : "mg\/dL",
               "value" : "49"
            },
            {
               "analytedate" : "04\/07\/2016",
               "analyteid" : "857458",
               "loinc" : "1188-6",
               "referencerange" : ">39",
               "units" : "mg\/dL",
               "value" : "76"
            }
         ],
         "name" : "HDL"
      },
      {
         "analytename" : "LDL cholesterol calc",
         "chartdata" : [
            {
               "analytedate" : "08\/22\/2015",
               "analyteid" : "742572",
               "loinc" : "3953-8",
               "referencerange" : "0-99",
               "units" : "mg\/dL",
               "value" : "96"
            },
            {
               "analytedate" : "12\/07\/2015",
               "analyteid" : "795598",
               "loinc" : "3953-8",
               "referencerange" : "0-99",
               "units" : "mg\/dL",
               "value" : "93"
            },
            {
               "analytedate" : "04\/07\/2016",
               "analyteid" : "857460",
               "loinc" : "3953-8",
               "referencerange" : "0-99",
               "units" : "mg\/dL",
               "value" : "101",
               "valuestatus" : "above high normal"
            }
         ],
         "name" : "LDL"
      },
   ],
   "medications" : [
      {
         "chartdata" : [
            {
               "events" : [
                  {
                     "eventdate" : "02\/20\/2016",
                     "medname" : "naproxen 500 mg tablet",
                     "refills" : "0",
                     "source" : "Argus Health Systems",
                     "strength" : "500||mg",
                     "type" : "FILL",
                     "medicationid" : "256627"
                  },
                  {
                     "eventdate" : "02\/20\/2016",
                     "medname" : "naproxen 500 mg tablet",
                     "refills" : "0",
                     "sig" : "Take 1 tablet(s) twice a day by oral route.",
                     "source" : "Manuela Womble",
                     "strength" : "500||mg",
                     "type" : "PRESCRIBE",
                     "medicationid" : "256627"
                  },
                  {
                     "eventdate" : "04\/10\/2016",
                     "medname" : "naproxen 500 mg tablet",
                     "refills" : "0",
                     "sig" : "Take 1 tablet(s) twice a day by oral route.",
                     "source" : "Manuela Womble",
                     "strength" : "500||mg",
                     "type" : "PRESCRIBE",
                     "medicationid" : "256627"
                  }
               ],
               "genericmedicationid" : "293894",
               ]
            }
         ],
         "name" : "naproxen"
      }
   ],
   "vitals" : [
      {
         "chartdata" : {
            "abbreviation" : "BP",
            "key" : "BLOODPRESSURE",
            "ordering" : 3,
            "readings" : [
               [
                  {
                     "clinicalelementid" : "VITALS.BLOODPRESSURE.DIASTOLIC",
                     "code" : "8462-4",
                     "codedescription" : "Diastolic blood pressure",
                     "codeset" : "LOINC",
                     "readingid" : "0",
                     "readingtaken" : "03\/21\/2016",
                     "source" : "ENCOUNTER",
                     "sourceid" : "178456",
                     "value" : "82",
                     "vitalid" : "211217"
                  },
                  {
                     "clinicalelementid" : "VITALS.BLOODPRESSURE.SYSTOLIC",
                     "code" : "8480-6",
                     "codedescription" : "Systolic blood pressure",
                     "codeset" : "LOINC",
                     "readingid" : "0",
                     "readingtaken" : "03\/21\/2016",
                     "source" : "ENCOUNTER",
                     "sourceid" : "178456",
                     "value" : "132",
                     "vitalid" : "211216"
                  }
               ]
            ]
         },
         "name" : "BP"
      },
      {
         "chartdata" : {
            "abbreviation" : "Ht",
            "key" : "HEIGHT",
            "ordering" : 0,
            "readings" : [
               [
                  {
                     "clinicalelementid" : "VITALS.HEIGHT",
                     "code" : "8302-2",
                     "codedescription" : "Body height",
                     "codeset" : "LOINC",
                     "readingid" : "0",
                     "readingtaken" : "03\/21\/2016",
                     "source" : "ENCOUNTER",
                     "sourceid" : "178456",
                     "unit" : "cm",
                     "value" : "168.1",
                     "vitalid" : "222213"
                  }
               ]
            ]
         },
         "name" : "Height"
      }
   ]
}
Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others

On this Page