Malama API Overview

The Malama API is used to integrate into patient record system with partners.

Security

Malama uses industry standard security practices:

• All Malama API usage requires authentication using OAuth2.
• All Malama API traffic is safely encrypted using TLS over HTTPS using trusted certificates.

FHIR

Malama’s API implements the HL7 FHIR specification. FHIR is an industry standard for healthcare data exchange.

The FHIR spec is comprehensive in its support for modeling healthcare data. Information on patients, orders, operating labs, ordering physicians, individual lab results, specimen collection methods, and much more are available. All of these resources are searchable and have a full user tracked audit history.

Glucose levels are available as FHIR resources.

You can search for Glucose levels using various properties.

For example, you can search by Patient:

request

curl https://api.heymalama.com/fhir/R4/GlucoseLevelsReport?patient=Patient/$PATIENT_ID \ -H "Authorization: Bearer $MY_ACCESS_TOKEN

The result of a GlucoseLevelsReport search will be a Bundle resource. Matching reports will be in the Bundle "entry".

A GlucoseLevelsReport is a collection of resources:

{
   "resourceType":"StructureDefinition",
   "id":"101",
   "text":{
      "status":"extensions",
      "div":"<div> <image src='trend image source'></image> <image src='glucose table image source'></image> </div>"
   },
   "status":"active",
   "version":"0.1.0",
   "title":"Malama Patient Blood Glucose",
   "experimental":false,
   "date":"2022-08-10T04:39:41+00:00",
   "publisher":"Malama Health",
   "kind":"resource",
   "abstract":false,
   "type":"Observation",
   "baseDefinition":"http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab",
   "derivation":"constraint",
   "snapshot":{
      "element":[
         {
            "reference":"Observation/f001"
         }
      ]
   }
}

Individual elements are represented by Observation resources:

{
   "resourceType":"Observation",
   "id":"f001",
   "status":"final",
   "code":{
    "coding":[
       {
          "system":"http://loinc.org",
          "code":"15074-8",
          "display":"Glucose [Moles/volume] in Blood"
       }
    ]
   },
   "subject":{
      "reference":"Patient/f001",
      "display":"Patient Name"
   },
   "issued":"2022-04-03T15:30:10+01:00",
   "performer":[
      {
         "reference":"Practitioner/f005",
         "display":"Malama Health"
      }
   ],
   "valueQuantity":{
      "value":145
      "unit":"mg/dL",
      "system":"http://unitsofmeasure.org",
      "code":"mg/dL"
   },
   "interpretation":[
      {
         "coding":[
            {
               "system":"http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation",
               "code":"H",
               "display":"High"
            }
         ]
      }
   ],
   "referenceRange":[
      {
         "low":{
            "value":70,
            "unit":"mg/dL",
            "system":"http://unitsofmeasure.org",
            "code":"mg/dL"
         },
         "high":{
            "value":135
            "unit":"mg/dL",
            "system":"http://unitsofmeasure.org",
            "code":"mg/dL"
         }
      }
   ]
}